إذا قرأت وثائق Windows للمطورين لأول مرة فسوف تمر عليك أسماء كثيرة في صفحات متجاورة: OLE وCOM وDCOM وActiveX وCOM+ و.NET وWinRT وUWP وWinUI وWindows App SDK، وكل اسم منها قدم في وقته على أنه الطريقة الجديدة لكتابة برامج Windows. والسؤال الذي يخطر لأي مطور عندها: هل هذه عشر تقنيات مختلفة يجب أن أتعلمها كلها، أم أنها تقنية واحدة تغير اسمها كل بضع سنوات؟ والإجابة الأقرب للحقيقة أنها طبقات فوق أساس واحد لم يتغير منذ 1993، وهذا ما سوف تراه بعينك في هذا المقال: عندما طلبنا في المختبر Lab كلاساً غير موجود من Windows Runtime، وهي أحدث هذه الطبقات، رجع الخطأ 0x80040154 Class not registered، أي الرمز نفسه حرفاً بحرف الذي رأيناه في مقال COM من الداخل مع كائن كتبناه بأنفسنا.
وقد بنينا في ذلك المقال خادم COM صغيراً وسجلناه وتتبعنا كل QueryInterface وAddRef وRelease، فلن نعيد شرح الجدول vtable وIUnknown وعداد المراجع Reference Count هنا، وإنما نختصرها في سطر عند الحاجة. وهدف هذا المقال مختلف: أن نفهم لماذا جاءت كل طبقة، وما المشكلة التي حلتها، وما الذي بقي منها في Windows 11، ثم ننزل إلى أحدث طبقة، Windows Runtime، ونفتحها من ثلاث جهات: من PowerShell، ومن C++ دون أي مكتبة مساعدة، ومن ملف البيانات الوصفية Metadata الذي يصفها.
وسوف نناقش في هذا المقال ما يلي:
- OLE والمستندات المركبة، ولماذا احتاجت Microsoft في 1993 أساساً اسمه COM.
- DCOM وActiveX وCOM+: كيف خرج COM إلى الشبكة والمتصفح والخادم، وما الثمن الأمني الذي ما زالت الشركات تدفعه.
- .NET في 2002: البيانات الوصفية وجامع النفايات Garbage Collector، والأغلفة التي تربطه بـ COM.
- Windows Runtime في 2012: IInspectable وHSTRING والتفعيل بالاسم وملفات winmd والإسقاطات Projections.
- مختبر على Windows 11 بصلاحيات مستخدم عادي: فئة Calendar بأربعة تقاويم من PowerShell، والواجهة الثنائية ABI من C++، وما في ملف
Windows.Globalization.winmdمن الداخل. - ماذا تختار اليوم لكل حالة، والأخطاء التي يقع فيها من ينتقل بين هذه الطبقات.
دليلنموذج المكونات COM من الداخل: الواجهات والتسجيلنبني خادم COM صغيراً بلغة C++ ونسجله للمستخدم الحالي فقط، ونتتبع كل QueryInterface وAddRef وRelease حتى نفهم لماذا يظهر Class not registered وE_NOINTERFACE.
دليلالمكتبات المشتركة DLL: التحميل وترتيب البحث وDLL Hellنبني مكتبة DLL صغيرة بأنفسنا ونراقب المحمل وهو يقرأ جداولها ويحملها ويستدعي DllMain، ثم نرى من أين جاء جحيم المكتبات وكيف عزله Windows بالنسخ جنباً إلى جنب.
دليلمن Win32 إلى WinUI: واجهات Windows عبر أربعين سنةلماذا جاءت كل تقنية لبناء واجهات Windows من Win32 إلى WinForms وWPF وWinUI، وما الذي بقي منها، مع النافذة نفسها مبنية بأربع طرق ومقاسة بالأرقام على Windows 11.
دليلواجهة Win32 API: كيف يكلم برنامجك نظام Windows؟نقرأ واجهة Win32 ببرامج C صغيرة على Windows 11: أين يعيش كود الدوال، ولماذا يتلف الاسم العربي مع نسخة A، وكيف تقرأ GetLastError وHRESULT دون أن يخدعك رقم قديم.
OLE: مستند داخل مستند Compound Documents
القصة لا تبدأ بالبرمجة، وإنما بطلب من مستخدمي Office في بداية التسعينات: أريد أن أضع جدولاً من Excel داخل تقرير Word، وعندما أعدل الأرقام في Excel يتغير الجدول في التقرير. وقبلها كان النسخ واللصق ينقل صورة ثابتة، وكانت هناك آلية اسمها تبادل البيانات الديناميكي DDE، واختصاراً لـ Dynamic Data Exchange، ترسل رسائل نوافذ بين برنامجين، وكانت هشة لأن البرنامجين يجب أن يعملا معاً ويتفقا على صيغة الرسائل.
فجاء ربط الكائنات وتضمينها OLE، واختصاراً لـ Object Linking and Embedding، بإصداره الأول في 1990، وفكرته أن المستند المركب Compound Document يحتوي «كائنات» يملكها برنامج آخر، فإذا نقرت على جدول Excel داخل Word فإن Excel هو الذي يرسمه ويعدله. والإصدار الأول بني على DDE نفسه، فورث مشاكله. وعندما بدأ الفريق في الإصدار الثاني اكتشف أن المشكلة الأعمق ليست في المستندات، وإنما في سؤال عام: كيف يستدعي برنامج كائناً في برنامج آخر لا يعرف عنه شيئاً، بلغة أخرى، وربما في عملية Process أخرى، دون أن يتعطل شيء عند تحديث أحدهما؟ والإجابة على هذا السؤال صارت أساساً مستقلاً سمي نموذج المكونات COM، وبني OLE 2.0 في 1993 فوقه. ومن أراد تفاصيل تلك المرحلة فمرجعها الكلاسيكي كتاب «Inside OLE» لـ Kraig Brockschmidt من Microsoft Press، وهو الكتاب الذي تعلم منه جيل كامل أن OLE مجرد تطبيق واحد لـ COM.
COM في 1993: الأساس الذي لم يتغير
شرحنا COM بمختبر كامل في المقال السابق، والخلاصة التي نحتاجها هنا ثلاث نقاط: الكائن يعطي العميل مؤشراً إلى جدول دوال بترتيب ثابت، وكل واجهة Interface لها معرف GUID ولا تتغير بعد نشرها، وكل واجهة ترث IUnknown بدوالها الثلاث QueryInterface وAddRef وRelease. ويصف Don Box في كتابه «Essential COM» الصادر في 1998 هذا التصميم في فصله الأول بعنوان «COM as a Better C++»، أي أن COM هو ما كانت C++ تحتاجه لتصلح للمكونات الثنائية Binary Components التي يبنيها كل فريق بمترجم مختلف.
والنقطة التي ستعود في كل قسم من هذا المقال هي أين يسجل الكلاس: في COM يعرف الكلاس برقم CLSID، ويبحث COM عنه تحت HKCR\CLSID فيجد مسار المكتبة في InprocServer32 أو البرنامج في LocalServer32. وهذا التسجيل هو أول ما ستتغير طريقته عندما نصل إلى WinRT.
DCOM: الكائن على جهاز آخر
بما أن العميل في COM لا يعرف إن كان الكائن في عمليته أو في عملية أخرى، فالخطوة التالية منطقية: لماذا لا يكون على جهاز آخر؟ وهذا ما جاء به COM الموزع DCOM، واختصاراً لـ Distributed COM، مع Windows NT 4.0 في 1996، أي على النواة التي رويناها في قصة Windows NT. فالوكيل Proxy الذي رأيناه في مقال COM ينقل الاستدعاء عبر استدعاء الإجراءات عن بعد RPC، واختصاراً لـ Remote Procedure Call، والبروتوكول نفسه موثق في مواصفة MS-DCOM.
وقد تبدو الفكرة من الوهلة الأولى جميلة، ولكن في الواقع فهي جلبت مشكلتين لم تختفيا. الأولى هي جدار الحماية Firewall: DCOM يبدأ بالمنفذ 135 ثم يتفق مع الطرف الآخر على منفذ عشوائي مرتفع، وهذا كابوس لكل مسؤول شبكة يريد أن يفتح أقل عدد من المنافذ. والثانية هي الأمان: كل كائن مكشوف على الشبكة سطح هجوم Attack Surface، والإعدادات القديمة كانت تقبل مستويات مصادقة Authentication ضعيفة حتى لا تتعطل البرامج القديمة. وهذه ليست قصة من التسعينات فقط: في يونيو 2021 بدأت Microsoft تقوية أمان DCOM بسبب الثغرة CVE-2021-26414، ونشرت خطة على ثلاث مراحل في المقال KB5004442: التقوية اختيارية في يونيو 2021، ثم مفعلة افتراضياً مع إمكانية إيقافها في يونيو 2022، ثم إلزامية دون أي خيار للإيقاف في 14 مارس 2023، بحيث يرفض خادم DCOM أي طلب تفعيل بمستوى مصادقة أقل من RPC_C_AUTHN_LEVEL_PKT_INTEGRITY. وكثير من الشركات اكتشفت عندها أن برنامجاً قديماً لإدارة المخازن أو أداة مراقبة تعتمد على DCOM توقفت عن الاتصال بالخادم بعد تحديث شهري، والدرس لكل مسؤول: كل تقنية تبقيها حية من أجل برنامج قديم ستطالبك يوماً بثمنها في نافذة التحديثات.
ActiveX: كائنات COM داخل المتصفح
في 1996 أيضاً، ومع سباق المتصفحات، أعادت Microsoft تسمية عناصر التحكم OLE Controls، وهي ملفات OCX مثل مكونات الجداول والرسوم التي يضعها مطورو Visual Basic في نوافذهم، باسم ActiveX، ووضعتها داخل صفحات الويب في Internet Explorer. فصار موقع الويب يستطيع أن يقول للمتصفح: نزل هذا الكائن وشغله داخل الصفحة، وهو كود أصلي Native Code له كل صلاحيات المستخدم، لا كود محصور في صندوق معزول Sandbox كما في JavaScript.
ونموذج الأمان كان التوقيع الرقمي Authenticode: يظهر للمستخدم اسم الشركة الموقعة ويسأله هل يثق بها. والمشكلة أن السؤال كان يقع على مستخدم لا يعرف ماذا يعني «نعم»، وأن الكائن الموقع من شركة محترمة قد تكون فيه ثغرة يستغلها أي موقع آخر يحمل الكائن نفسه. ولذلك أضافت Microsoft آلية «بت الإيقاف» Kill Bit في السجل لمنع كائنات محددة من العمل في المتصفح، وصارت تحديثات الأمان الشهرية لسنوات تحمل قوائم كائنات ActiveX مضافة إلى قائمة الإيقاف. وانتهت القصة رسمياً مع انتهاء دعم Internet Explorer 11 في 15 يونيو 2022 على أغلب إصدارات Windows 10، ولم يعد ActiveX يعمل إلا في وضع IE داخل Edge لمن يحتاجه في تطبيقات داخلية قديمة. ولاحظ أن ActiveX انتهى في المتصفح فقط، فالكائنات نفسها، أي كائنات COM التي تعرض نافذة، ما زالت تعمل داخل برامج سطح المكتب.
COM+: الخدمات حول الكائن
عندما بدأت الشركات تبني تطبيقات أعمال من طبقات، كانت تحتاج أشياء لا علاقة لها بمنطق الكائن نفسه: معاملات Transactions تشمل قاعدتي بيانات، وتجمع كائنات Object Pooling بدل إنشائها مع كل طلب، وصلاحيات بحسب الدور Role-based Security. فجاء خادم المعاملات من Microsoft واختصاراً MTS، ثم دمج في Windows 2000 باسم COM+، وما زالت أداة خدمات المكونات Component Services، التي تفتحها بالأمر dcomcnfg، موجودة في Windows 11 بالشكل نفسه تقريباً، ووثائقها في Component Services. والفكرة الذكية في COM+ هي الاعتراض Interception: COM يضع وكيلاً بين العميل والكائن حتى داخل العملية نفسها، فيبدأ المعاملة قبل الاستدعاء ويثبتها أو يلغيها بعده، دون أن يكتب المطور سطراً واحداً عن المعاملات. وهذه الفكرة نفسها هي ما ستراه لاحقاً في .NET وفي أطر الويب الحديثة تحت اسم البرمجيات الوسيطة Middleware.
.NET في 2002: ما الذي كان ينقص COM؟
بعد عشر سنوات من COM كانت مشاكله معروفة لكل مطور Windows: عداد المراجع اليدوي مصدر دائم لتسرب الذاكرة Memory Leak وسقوط البرامج، ووصف الواجهات موزع بين ملفات IDL ومكتبات الأنواع Type Libraries التي لا تصف كل شيء، والتسجيل في السجل Registry يجعل كل تثبيت وحذف مغامرة، وتعدد النسخ من الكلاس نفسه على جهاز واحد شبه مستحيل لأن الـ CLSID واحد. وكانت Microsoft تبني في الوقت نفسه إجابة كاملة على هذه المشاكل اسمها .NET Framework، صدر إصدارها الأول في فبراير 2002:
- جامع النفايات Garbage Collector بدل العداد: لا AddRef ولا Release، ووقت التشغيل Runtime يعرف متى لم يعد أحد يستخدم الكائن.
- البيانات الوصفية Metadata في كل ملف: كل مكتبة .NET تحمل وصفاً كاملاً لأنواعها ودوالها ومعاملاتها في جداول ثنائية بصيغة موحدة، صارت لاحقاً المعيار الدولي ECMA-335. فلا حاجة لملف ترويسة منفصل ولا لمكتبة أنواع.
- لا تسجيل في السجل للمكتبات العادية: المكتبة توضع بجانب البرنامج، أو في مخزن مشترك بإصدارات متعددة.
ولكن .NET لم يلغ COM، لأن Windows نفسه وOffice وآلاف البرامج كانت مبنية عليه، فجاء معه جسر في الاتجاهين تشرحه صفحة COM Interop: غلاف Runtime Callable Wrapper يجعل كائن COM يظهر لـ .NET ككائن عادي، وهو النوع System.__ComObject الذي رأيناه في PowerShell في المقال السابق، وغلاف COM Callable Wrapper يعرض كائن .NET لعملاء COM. وبقيت مشكلة واحدة كبيرة لم يحلها .NET: الواجهات الجديدة لـ Windows نفسه بقيت تكتب بـ C وC++ وCOM، لأن فرق Windows لم تكن مستعدة لأن يعتمد النظام كله على وقت تشغيل .NET وجامع نفاياته، فبقي مطور .NET يكتب تعريفات P/Invoke وواجهات COM يدوياً لكل دالة جديدة في النظام.
Windows Runtime في 2012: COM مع ما تعلمته Microsoft من .NET
مع Windows 8 في أكتوبر 2012 قررت Microsoft أن تبني الواجهات الجديدة للنظام بطريقة تأخذ أفضل ما في الطرفين: الأداء والاستقلال عن اللغة من COM، والبيانات الوصفية والأدوات من .NET. والنتيجة اسمها Windows Runtime، واختصاراً WinRT، ويصفها كتاب «Windows Internals» في إصداره السابع بأنها مبنية فوق COM مع إضافات عليه، وهذه الإضافات هي موضوع بقية المقال:
| المشكلة في COM | حلها في WinRT |
|---|---|
| العميل لا يستطيع أن يسأل الكائن «ما أنت؟» | واجهة أساسية جديدة IInspectable ترث IUnknown وتضيف ثلاث دوال |
| الكلاس رقم CLSID لا يقرؤه أحد | الكلاس اسم نصي كامل مثل Windows.Globalization.Calendar |
| وصف الواجهات في ملفات IDL ومكتبات أنواع ناقصة | ملفات winmd بصيغة ECMA-335 نفسها التي يستخدمها .NET |
| النصوص BSTR تنسخ في كل استدعاء | HSTRING: نص ثابت لا يتغير Immutable بعداد مراجع، ويمكن تمريره دون نسخ |
| كل لغة تتعامل مع COM بطريقة مختلفة ومؤلمة | إسقاط Projection لكل لغة يولد من البيانات الوصفية، فيرى مطور C# كلاسات C# ويرى مطور C++ كلاسات C++ |
وقد يتساءل البعض: لماذا تخلت WinRT عن الـ GUID للكلاسات واختارت اسماً نصياً، مع أن الـ GUID صمم أصلاً حتى لا يتصادم اسمان؟ والإجابة أن مشكلة التصادم حلت بطريقة أخرى، وهي فضاء الأسماء Namespace الذي تعرفه من .NET وJava: كل كلاسات Microsoft تحت Windows.، وكل شركة تضع كلاساتها تحت اسمها، فالتصادم ممكن نظرياً ولكنه لا يحدث عملياً. وفي المقابل ربحت WinRT أشياء كثيرة: رسالة الخطأ تحمل اسماً يفهمه المطور، والكود يقرأ دون جدول تحويل، والأهم أن الاسم نفسه هو مفتاح البحث في ملفات البيانات الوصفية، فالنظام يعرف من الاسم Windows.Globalization.Calendar أن وصفه في الملف Windows.Globalization.winmd. وأما الواجهات فبقي لها GUID كما هي في COM، لأن QueryInterface يحتاج رقماً ثابتاً يقارنه بسرعة، ولأن الواجهة هي العقد الثنائي الذي يجب ألا يعتمد على أي اسم.
وتصف Microsoft نظام الأنواع كاملاً في صفحة Windows Runtime type system. والآن ننزل إلى المختبر لنرى كل سطر في الجدول أعلاه على جهاز حقيقي.
تجهيز المختبر Lab
المختبر على جهاز Windows 11 Pro 24H2 حقيقي بحساب مستخدم عادي Standard User، ولا يكتب أي مفتاح في السجل، وإنما يقرأ فقط. والملفات في مجلد lab المرفق بالمقال:
01-powershell.ps1: يستخدم فئتي Calendar وLanguage من Windows PowerShell 5.1.winrt.cpp: برنامج C++ يستدعي الفئات نفسها عبر الواجهة الثنائية ABI، واختصاراً لـ Application Binary Interface، دون C++/WinRT ودون أي إسقاط، ويبنى بـ MinGW-w64 في Container مؤقت كما في المقال السابق، فملفات الترويسة الخاصة بـ WinRT تأتي مع MinGW نفسه.winmd-dump: برنامج .NET صغير يقرأ ملف winmd بمكتبة System.Reflection.Metadata.
cd lab
copy C:\Windows\System32\WinMetadata\Windows.Globalization.winmd winmd\
docker run --rm -v "${PWD}:/src" -w /src alpine:3.22 sh build.sh
powershell -NoProfile -ExecutionPolicy Bypass -File run.ps1OS: Microsoft Windows 11 Pro 24H2, build 26100.9711
PowerShell: 5.1.26100.9711, CLR 4.0.30319.42000
Elevated (Administrator token): False
.NET SDK for winmd-dump (pinned by global.json): 10.0.400
WinMetadata folder: 20 .winmd files, 6.9 MBولاحظ السطر الأخير: مجلد WinMetadata في هذا الجهاز فيه 20 ملف winmd بحجم 6.9 ميجابايت، وهذه الملفات هي الوصف الكامل لكل واجهات WinRT التي يقدمها النظام، وسوف نفتح واحداً منها في آخر المختبر.
التجربة الأولى: تقويم أم القرى من PowerShell
Windows PowerShell 5.1 مبني على .NET Framework 4، وهذا الإصدار من .NET يعرف WinRT بنفسه، فيكفي أن تذكر اسم النوع مع ContentType=WindowsRuntime مرة واحدة، ثم تستخدمه ككلاس .NET عادي. وهذا جزء من السكربت:
$null = [Windows.Globalization.Calendar, Windows.Globalization, ContentType = WindowsRuntime]
$null = [Windows.Globalization.Language, Windows.Globalization, ContentType = WindowsRuntime]
$out = @()
$when = [DateTimeOffset]::new(2026, 11, 20, 12, 0, 0, [TimeSpan]::FromHours(3))
$out += "> Calendar for $($when.ToString('yyyy-MM-dd HH:mm zzz')) in four calendar systems, with the language list @('ar-SA')"
foreach ($system in 'GregorianCalendar', 'UmAlQuraCalendar', 'HijriCalendar', 'PersianCalendar') {
$c = [Windows.Globalization.Calendar]::new([string[]]@('ar-SA'), $system, '24HourClock')
$c.SetDateTime($when)
$out += "{0,-18} {1} {2} {3} ({4}), numerals {5}" -f $system, $c.DayAsString(), $c.MonthAsString(), $c.YearAsString(), $c.DayOfWeekAsString(), $c.NumeralSystem
}والمخرج سوف يكون كما يلي:
> Calendar for 2026-11-20 12:00 +03:00 in four calendar systems, with the language list @('ar-SA')
GregorianCalendar ٢٠ نوفمبر ٢٠٢٦ (الجمعة), numerals Arab
UmAlQuraCalendar ١٠ جمادى الثانية ١٤٤٨ (الجمعة), numerals Arab
HijriCalendar ١٠ جمادى الثانية ١٤٤٨ (الجمعة), numerals Arab
PersianCalendar ٢٩ آبان ١٤٠٥ (جمعه), numerals Arab
UmAlQuraCalendar with NumeralSystem = Latn: 10 جمادى الثانية 1448
> What PowerShell sees
type: Windows.Globalization.Calendar, assembly: Windows.Globalization, Version=255.255.255.255, Culture=neutral, PublicKeyToken=null, ContentType=WindowsRuntime
IsCOMObject: True, methods visible: 54
> Languages
ar-SA Arabic (Saudi Arabia) | العربية (المملكة العربية السعودية) | script Arab
ar Arabic | العربية | script Arab
en-US English (United States) | English (United States) | script Latn
IsWellFormed('ar-SA') = True, IsWellFormed('not a tag!') = False
> What happens if the calendar name is wrong?
System.ArgumentException: HResult 0x80070057, The parameter is incorrect. | calendar
وفي المخرج أعلاه لاحظ التالي:
- التقويم كله يأتي من النظام: أسماء الأشهر الهجرية وأيام الأسبوع والأرقام ٠ إلى ٩ كلها من فئة Windows.Globalization.Calendar، والسكربت لم يكتب جدول أشهر واحداً. وتقويم أم القرى UmAlQuraCalendar مدعوم كنظام مستقل عن الهجري الحسابي HijriCalendar، واتفق الاثنان في هذا اليوم.
- نظام الأرقام Numeral System خاصية مستقلة: اللغة ar-SA اختارت الأرقام العربية الهندية
Arabافتراضياً، وبتغيير خاصية واحدة إلىLatnصارت الأرقام 10 و1448. وهذا ما يحتاجه أي تطبيق يعرض التاريخ الهجري في واجهة تستخدم الأرقام الغربية. - الكائن كائن COM: السطر
IsCOMObject: Trueيقول إن ما بيد PowerShell غلاف حول مؤشر COM، ولكن هذه المرة بنوع واضحWindows.Globalization.Calendarو54 دالة مرئية، لأن .NET قرأ وصف الكلاس من ملف winmd، لا من مكتبة أنواع. - اسم المكتبة في .NET هو
Windows.Globalization, Version=255.255.255.255, ContentType=WindowsRuntime: لا توجد مكتبة .NET بهذا الاسم على القرص، وإنما يحمل .NET ملف winmd الذي يحمل الاسم نفسه ويعامله كمكتبة. والإصدار 255.255.255.255 ليس إصداراً حقيقياً، وإنما قيمة ثابتة تكتب في كل ملفات winmd، لأن إصدار الواجهات في WinRT لا يأتي من رقم المكتبة، وإنما من العقود التي سنشرحها بعد قليل، ولأن ملف winmd واحد على الجهاز يمثل دائماً ما يقدمه النظام المثبت الآن. - اسم الجمعة بالفارسية «جمعه» في التقويم الفارسي، لأن التقويم يختار أسماءه بحسب ثقافته لا بحسب اللغة وحدها، وهذا تفصيل يفاجئ من يعرض التواريخ لمستخدمين من عدة دول.
- الخطأ
0x80070057عند اسم تقويم غير موجود ظهر في .NET كاستثناءArgumentException، ومعه كلمةcalendarاسم المعامل الخاطئ. فالإسقاط يحول كل HRESULT إلى استثناء من النوع المناسب، وينقل معه معلومات الخطأ التي كتبها الكائن.
ContentType=WindowsRuntime فشغله بـ powershell.exe وليس pwsh.exe، والفروق بين الاثنين في مقال PowerShell للمسؤولين.التجربة الثانية: الواجهة الثنائية ABI من C++ دون إسقاط
PowerShell أخفى كل شيء، والآن نستدعي الكلاس نفسه بالطريقة التي يراها المعالج فعلاً. والبرنامج winrt.cpp يستخدم ثلاث دوال من مكتبة النظام combase: RoActivateInstance لإنشاء كائن من كلاس له منشئ Constructor دون معاملات، وRoGetActivationFactory للحصول على مصنع التفعيل Activation Factory لكلاس يحتاج معاملات، ودوال HSTRING. وهذا الجزء الأول منه:
// 1) A class with a default constructor: RoActivateInstance returns its IInspectable
IInspectable *cal = nullptr;
hr = RoActivateInstance(Name(L"Windows.Globalization.Calendar").s, &cal); SHOW(L"RoActivateInstance(Calendar)", hr);
if (cal) {
HSTRING n; cal->GetRuntimeClassName(&n); out(L" GetRuntimeClassName -> %ls", str(n).c_str());
TrustLevel t; cal->GetTrustLevel(&t); out(L" GetTrustLevel -> %d (0 BaseTrust, 1 PartialTrust, 2 FullTrust)", (int)t);
ULONG count = 0; IID *iids = nullptr; cal->GetIids(&count, &iids);
out(L" GetIids -> %lu interfaces:", count);
for (ULONG i = 0; i < count; i++) { wchar_t g[40]; StringFromGUID2(iids[i], g, 40); out(L" %ls", g); }
CoTaskMemFree(iids);
IUnknown *agile = nullptr; static const IID IID_IAgileObject_ = {0x94ea2b94, 0xe9cc, 0x49e0, {0xc0, 0xff, 0xee, 0x64, 0xca, 0x8f, 0x5b, 0x90}};
hr = cal->QueryInterface(IID_IAgileObject_, (void **)&agile); SHOW(L" QueryInterface(IAgileObject)", hr);
if (agile) agile->Release();
cal->Release();
}والمخرج كاملاً:
> winrt.exe
RoInitialize(MTA) hr=0x00000000 The operation completed successfully.
RoActivateInstance(Calendar) hr=0x00000000 The operation completed successfully.
GetRuntimeClassName -> Windows.Globalization.Calendar
GetTrustLevel -> 0 (0 BaseTrust, 1 PartialTrust, 2 FullTrust)
GetIids -> 4 interfaces:
{CA30221D-86D9-40FB-A26B-D44EB7CF08EA}
{00000038-0000-0000-C000-000000000046}
{BB3C25E5-46CF-4317-A3F5-02621AD54478}
{0CA51CC6-17CF-4642-B08E-473DCC3CA3EF}
QueryInterface(IAgileObject) hr=0x00000000 The operation completed successfully.
DLLs that the activation loaded into this process:
C:\Windows\System32\Bcp47Langs.dll
C:\Windows\System32\Windows.Globalization.dll
C:\Windows\System32\clbcatq.dll
C:\Windows\System32\wintypes.dll
RoActivateInstance(Language) hr=0x80004001 Not implemented
RoGetActivationFactory(Language, ILanguageFactory) hr=0x00000000 The operation completed successfully.
ar-SA DisplayName=Arabic (Saudi Arabia) | NativeName=العربية (المملكة العربية السعودية) | Script=Arab
ar-EG DisplayName=Arabic (Egypt) | NativeName=العربية (مصر) | Script=Arab
en-US DisplayName=English (United States) | NativeName=English (United States) | Script=Latn
CreateLanguage("not a tag!") hr=0x80070057 The parameter is incorrect.
RoGetActivationFactory(GeographicRegion) hr=0x00000000 The operation completed successfully.
SA -> CodeThreeLetter=SAU | DisplayName=Saudi Arabia | NativeName=المملكة العربية السعودية
RoActivateInstance(NoSuchClass) hr=0x80040154 Class not registered
HSTRING of 8 UTF-16 code units: WindowsGetStringLen=8, embedded null=yes
(exit code 0)وهذا المخرج يستحق أن نقرأه سطراً سطراً، لأن كل سطر فيه يقابل خانة في الجدول الذي قارنا فيه COM بـ WinRT:
RoInitialize(MTA): المقابل لـCoInitializeExفي COM، وفكرة الشقق Apartments نفسها باقية.- RoActivateInstance باسم نصي: لا يوجد CLSID في الكود إطلاقاً، وإنما
"Windows.Globalization.Calendar". والكائن رجع كمؤشرIInspectable*. - GetRuntimeClassName: الكائن يعرف اسمه ويقوله، وهذا ما لم يكن ممكناً في COM التقليدي إلا إذا طبق الكائن واجهات إضافية اختيارية.
- GetIids رجعت 4 واجهات: هذه الدالة تعطي قائمة الواجهات التي يطبقها الكائن ما عدا IUnknown وIInspectable، كما تشرح صفحة IInspectable::GetIids. ولاحظ أن اثنتين منها من نوع
{0000xxxx-0000-0000-C000-000000000046}، وهذا النطاق محجوز لواجهات COM التي عرفتها Microsoft منذ التسعينات، وسوف نعرف أسماء الأربع في التجربة الثالثة. - GetTrustLevel رجعت 0 أي BaseTrust: الكلاس يعمل داخل أي عملية حتى داخل تطبيق في صندوق معزول AppContainer.
- QueryInterface(IAgileObject) نجحت: الكائن «رشيق» Agile، أي يمكن استدعاؤه من أي خيط Thread دون Proxy. وتذكر مشكلة E_NOINTERFACE من شقة MTA في مقال COM: أغلب كلاسات WinRT تعلن أنها Agile فتختفي تلك المشكلة كلها، وهذا قرار تصميم مقصود.
- أربع مكتبات DLL حملها التفعيل:
Windows.Globalization.dllهي التي فيها الكود، وwintypes.dllهي مكتبة نظام الأنواع في WinRT، وclbcatq.dllهي مكتبة كتالوج COM+ التي يقرأ منها COM التسجيل، وBcp47Langs.dllلوسوم اللغات. فالتفعيل في WinRT يمر عبر البنية نفسها التي يمر عبرها COM.

كلاس دون منشئ فارغ: مصنع التفعيل
السطر RoActivateInstance(Language) hr=0x80004001 Not implemented هو مشكلة حقيقية قابلتنا أثناء كتابة البرنامج: الكلاس Windows.Globalization.Language لا يمكن إنشاؤه دون وسم لغة، فلا يوجد له منشئ فارغ، وRoActivateInstance لا تعرف إلا المنشئ الفارغ، فرجعت E_NOTIMPL. والحل هو أن تطلب المصنع نفسه، أي الكائن الذي يطبق IActivationFactory وواجهات مصنع خاصة بالكلاس، ثم تطلب منه واجهة ILanguageFactory وتستدعي CreateLanguage بالوسم. وهذا ما يفعله الجزء الثاني من البرنامج:
// 2) A class without a default constructor: ask for its activation factory and call the factory method
IInspectable *nodefault = nullptr;
hr = RoActivateInstance(Name(L"Windows.Globalization.Language").s, &nodefault); SHOW(L"RoActivateInstance(Language)", hr);
ILanguageFactory *lf = nullptr;
hr = RoGetActivationFactory(Name(L"Windows.Globalization.Language").s, __uuidof(ILanguageFactory), (void **)&lf);
SHOW(L"RoGetActivationFactory(Language, ILanguageFactory)", hr);
if (lf) {
for (const wchar_t *tag : { L"ar-SA", L"ar-EG", L"en-US" }) {
ILanguage *lang = nullptr;
hr = lf->CreateLanguage(Name(tag).s, &lang);
if (FAILED(hr)) { SHOW(L" CreateLanguage", hr); continue; }
HSTRING a, b, c, d; lang->get_LanguageTag(&a); lang->get_DisplayName(&b); lang->get_NativeName(&c); lang->get_Script(&d);
std::wstring A = str(a), B = str(b), C = str(c), D = str(d);
out(L" %-6ls DisplayName=%ls | NativeName=%ls | Script=%ls", A.c_str(), B.c_str(), C.c_str(), D.c_str());
lang->Release();
}
ILanguage *bad = nullptr; hr = lf->CreateLanguage(Name(L"not a tag!").s, &bad); SHOW(L" CreateLanguage(\"not a tag!\")", hr);
if (bad) bad->Release();
lf->Release();
}والنتائج ثلاث لغات بأسمائها الأصلية Native Names، ووسم خاطئ رجع E_INVALIDARG، ثم الفئة GeographicRegion بالطريقة نفسها أعطت اسم المملكة بالعربية ورمزها الثلاثي SAU. ولاحظ أن الأسماء العربية في المخرج تنتهي بعلامة اتجاه غير مرئية بعد القوس، وهي علامة يضيفها Windows ليبقى النص العربي صحيح الاتجاه عندما يوضع داخل سطر إنجليزي، فإذا قارنت هذه الأسماء بنص كتبته يدوياً فستجد أنها غير متساوية، وهذا خطأ صغير يضيع فيه بعض الوقت.
وفي المقابل، الإسقاط في PowerShell أخفى هذا الفرق تماماً: كتبنا [Windows.Globalization.Language]::new('ar-SA') وكأنها كلاس .NET بمنشئ عادي، والإسقاط هو الذي ذهب إلى المصنع واستدعى CreateLanguage. وهذا بالضبط ما تعنيه كلمة «إسقاط»: البيانات الوصفية تقول إن للكلاس مصنعاً بدالة CreateLanguage، فيحولها إسقاط C# إلى منشئ، وإسقاط C++/WinRT إلى منشئ أيضاً، ولكن تحت السطر نفسه في الحالتين استدعاء مصنع.
HSTRING والخطأ الذي يعرفه كل مطور COM
السطر الأخير قبل رمز الخروج يبين أن HSTRING يحمل طوله معه، فنص من 8 وحدات UTF-16 فيه حرف صفري Null في وسطه بقي طوله 8، والدالة WindowsStringHasEmbeddedNull اكتشفت الصفر. وفي البرنامج نستخدم أيضاً «المرجع السريع» Fast-pass String Reference بالدالة WindowsCreateStringReference: نص يشير إلى ذاكرتنا نحن دون أي نسخ أو حجز، وهو آمن ما دام الاستدعاء لا يحتفظ بالنص بعد أن يرجع، والتفاصيل في صفحة HSTRING. وأما السطر RoActivateInstance(NoSuchClass) hr=0x80040154 Class not registered فهو الذي بدأنا به المقال: WinRT لم يخترع رموز أخطاء جديدة لهذه الحالة، وإنما استخدم REGDB_E_CLASSNOTREG من COM كما هو.
أين يسجل WinRT كلاساته؟
في COM كتبنا CLSID تحت HKCU\Software\Classes\CLSID، فأين يجد RoActivateInstance اسماً نصياً؟ السكربت يقرأ المفتاح المقابل:
> reg query HKLM\SOFTWARE\Microsoft\WindowsRuntime\ActivatableClassId\Windows.Globalization.Calendar /s
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsRuntime\ActivatableClassId\Windows.Globalization.Calendar
ActivationType REG_DWORD 0x0
DllPath REG_SZ C:\Windows\System32\Windows.Globalization.dll
Threading REG_DWORD 0x0
TrustLevel REG_DWORD 0x0
> reg query HKLM\SOFTWARE\Microsoft\WindowsRuntime\ActivatableClassId\Windows.Globalization.Language /s
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsRuntime\ActivatableClassId\Windows.Globalization.Language
ActivationType REG_DWORD 0x0
DllPath REG_SZ C:\Windows\System32\Windows.Globalization.dll
Threading REG_DWORD 0x0
TrustLevel REG_DWORD 0x0
Activatable classes registered on this machine: 4784
> reg query HKCR\CLSID\Windows.Globalization.Calendar /s
ERROR: The system was unable to find the specified registry key or value.وفي المخرج أعلاه لاحظ التالي:
- المفتاح باسم الكلاس تحت
HKLM\SOFTWARE\Microsoft\WindowsRuntime\ActivatableClassId، وفيهDllPathالمقابل لـ InprocServer32، وThreadingالمقابل لـ ThreadingModel، وTrustLevelالذي رجعته GetTrustLevel. - Calendar وLanguage في المكتبة نفسها، فالمكتبة الواحدة تستضيف كلاسات كثيرة وتعطي مصنع كل منها من دالتها المصدرة
DllGetActivationFactory، المقابلة لـ DllGetClassObject في COM. - 4784 كلاساً قابلاً للتفعيل مسجلة على هذا الجهاز، ولا يوجد أي CLSID باسم Calendar تحت HKCR، فالنظامان متوازيان.
- التسجيل تحت HKLM فقط لكلاسات النظام. وأما التطبيقات المحزمة Packaged Apps فتسجل كلاساتها في ملف المانيفست Manifest الخاص بالحزمة، لا في السجل، وهذا من أكبر الفروق العملية عن COM: حذف التطبيق يحذف تسجيله معه.

التجربة الثالثة: ماذا يوجد داخل ملف winmd؟
الإسقاطات كلها تقرأ من ملفات winmd، فما هذه الملفات؟ تشرح صفحة Windows Metadata (WinMD) files أنها تستخدم صيغة البيانات الوصفية في ECMA-335 مع قيود وإضافات خاصة بـ WinRT. ولكي نتحقق من هذا بأنفسنا فتحنا الملف بأداتين: objdump من MinGW يرى رؤوس الملف الثنائي، وبرنامج winmd-dump الذي كتبناه بـ .NET 8 يقرأ الجداول. وهذا مخرج الاثنين:
> winmd-dump Windows.Globalization.winmd Windows.Globalization.Calendar <the 4 IIDs from GetIids>
file: Windows.Globalization.winmd, 87,864 bytes
PE machine: I386, CLI header: yes, metadata version string: "WindowsRuntime 1.4"
tables: 105 TypeDef, 1101 MethodDef, 464 CustomAttribute; methods with a code body (RVA != 0): 0
interfaces and delegates with a GUID in this file: 63
types: 15 enum, 63 interface, 25 runtime class, 1 struct
class Windows.Globalization.Calendar
flags: Public, Sealed, Import, WindowsRuntime
base type: System.Object
[MarshalingBehaviorAttribute]
[ActivatableAttribute]
[DualApiPartitionAttribute]
[ThreadingAttribute]
[ActivatableAttribute]
[ActivatableAttribute]
[ContractVersionAttribute]
implements Windows.Globalization.ICalendar [Default] {CA30221D-86D9-40FB-A26B-D44EB7CF08EA} 98 methods
implements Windows.Globalization.ITimeZoneOnCalendar {BB3C25E5-46CF-4317-A3F5-02621AD54478} 4 methods
constructors: 4 (parameters: 4, 1, 3, 0)
first methods: Clone, SetToMin, SetToMax, get_Languages, get_NumeralSystem, put_NumeralSystem, GetCalendarSystem, ChangeCalendarSystem
methods with a code body: 0 of 106
IIDs resolved from this file's GuidAttribute values:
{CA30221D-86D9-40FB-A26B-D44EB7CF08EA} -> Windows.Globalization.ICalendar
{00000038-0000-0000-C000-000000000046} -> (in no .winmd file: a classic COM interface)
{BB3C25E5-46CF-4317-A3F5-02621AD54478} -> Windows.Globalization.ITimeZoneOnCalendar
{0CA51CC6-17CF-4642-B08E-473DCC3CA3EF} -> (in no .winmd file: a classic COM interface)
> objdump -x Windows.Globalization.winmd (selected lines)
Characteristics 0x2102
Magic 010b (PE32)
SizeOfCode 00000000
Subsystem 00000003 (Windows CUI)
Entry 0 00000000 00000000 Export Directory [.edata (or where ever we found it)]
Entry 1 00000000 00000000 Import Directory [parts of .idata]
Entry b 00000000 00000000 Bound Import Directory
Entry d 00000000 00000000 Delay Import Directory
Entry e 00001000 00000048 CLR Runtime Header
Sections:
0 .text 0000fd60 00401000 00401000 00000200 2**2
1 .rsrc 00000360 00411000 00411000 00010000 2**2وهذا ما يقوله المخرج عن الملف:
- هو ملف PE عادي، أي بالصيغة نفسها لملفات exe وdll، لمعمارية I386 أي 32 بت، وحتى على Windows 64 بت، لأنه لا يحتوي كوداً ينفذ أصلاً:
SizeOfCode 00000000، ولا جدول استيراد Import ولا تصدير Export. - رأس CLR Runtime Header موجود في المدخل
eمن دليل البيانات Data Directory، وهو المدخل نفسه الذي يميز أي مكتبة .NET، والنسخة المكتوبة في البيانات الوصفية"WindowsRuntime 1.4"بدل رقم إصدار .NET. - 105 أنواع و1101 دالة ولا جسم لأي منها: السطر
methods with a code body (RVA != 0): 0هو جوهر الفكرة كلها، فالملف يصف الأنواع فقط، والكود الحقيقي فيWindows.Globalization.dllالتي رأيناها في التجربة الثانية. - الكلاس Calendar مختوم Sealed وعليه العلامة
WindowsRuntime، ويرثSystem.Objectاسمياً فقط حتى تفهمه أدوات .NET، وعليه ثلاث سماتActivatableAttributeتقابل المنشئات: الفارغ، وواجهة مصنع واحدة أو أكثر. ولذلك نجح RoActivateInstance مع Calendar وفشل مع Language. - الواجهة الافتراضية [Default] هي ICalendar بـ 98 دالة، وهي الواجهة التي يرجعها المؤشر عندما لا تحدد غيرها، والمعرف
{CA30221D-...}هو أول ما رجعته GetIids في التجربة الثانية. - اثنتان من الأربع ليستا في أي ملف winmd:
{00000038-...}هي واجهة COM التقليدية IWeakReferenceSource التي تسمح بالمراجع الضعيفة Weak References، والرابعة واجهة COM داخلية لا يصفها أي ملف. فكائن WinRT يطبق واجهات WinRT الموصوفة وواجهات COM عادية جنباً إلى جنب.

مشكلة قابلتنا في قراءة الملف
في أول تشغيل لبرنامج winmd-dump ظهرت الواجهتان ICalendar وITimeZoneOnCalendar بصفر دالة ودون GUID، مع أنهما معرفتان في الملف نفسه. والسبب أن ملفات winmd تشير حتى إلى واجهاتها هي من خلال جدول مراجع الأنواع TypeRef، لا من خلال جدول تعريفات الأنواع TypeDef مباشرة كما تفعل أغلب مكتبات .NET، فكان البرنامج يبحث عن تعريف في المكان الخطأ. والحل كان أن يأخذ الاسم الكامل من المرجع ثم يبحث عنه بين تعريفات الملف، وهو ما تراه في الكود المرفق. فإذا كتبت أداة تقرأ winmd فلا تفترض أنها مكتبة .NET عادية، والأفضل أن تبدأ من أدوات Microsoft نفسها.
كيف يضيف WinRT ميزات دون أن يتعطل البرنامج القديم؟ العقود Contracts
في مخرج winmd-dump سمة لم نشرحها بعد: [ContractVersionAttribute] على الكلاس Calendar. وهذه السمة هي جواب WinRT عن مشكلة قديمة في COM. ففي COM كانت القاعدة أن الواجهة المنشورة لا تتغير، وأن الميزة الجديدة تأتي في واجهة جديدة، وهذه القاعدة بقيت كما هي في WinRT، ولكنها لم تكن كافية، والسبب أن البرنامج يحتاج أن يعرف قبل الاستدعاء هل الواجهة الجديدة موجودة على جهاز هذا المستخدم بالذات، لأن تطبيقاً واحداً قد يعمل على إصدارات متعددة من Windows 10 و11. ففي COM كان البرنامج يجرب QueryInterface ويرى هل تنجح، وهذا يعمل مع الواجهات ولكنه لا يعمل مع كلاس كامل غير موجود ولا مع دالة ثابتة Static جديدة.
والحل في WinRT أن كل نوع ينتمي إلى عقد API Contract باسم ورقم إصدار، مثل Windows.Foundation.UniversalApiContract، والسمة ContractVersion في البيانات الوصفية تقول في أي إصدار من العقد ظهر النوع. وفي وقت التشغيل يسأل البرنامج النظام بالكلاس ApiInformation: هل هذا النوع موجود؟ هل هذه الدالة موجودة؟ هل هذا العقد بهذا الإصدار موجود؟ ثم يقرر أن يستخدم الميزة الجديدة أو يرجع إلى الطريقة القديمة، وهذه الطريقة تسميها Microsoft الكود المتكيف مع الإصدار Version Adaptive Code. ولاحظ أن الإجابة تأتي من ملفات winmd المثبتة على الجهاز نفسه، فالبيانات الوصفية ليست أداة للمترجم فقط كما في .NET، وإنما جزء من النظام يقرؤه البرنامج وهو يعمل.
وهذا يفسر أيضاً لماذا وجدنا في التجربة الثانية أن Calendar يطبق ICalendar وITimeZoneOnCalendar في واجهتين منفصلتين: الثانية أضيفت لاحقاً لدعم المناطق الزمنية، فلم تعدل ICalendar ذات الـ 98 دالة، وإنما أضيفت واجهة جديدة بجانبها، تماماً كما فعلت Microsoft مع IShellDispatch حتى IShellDispatch6 في COM. فالقاعدة نفسها، والجديد أن هناك طريقة موحدة للسؤال عنها.
العمليات غير المتزامنة Asynchronous Operations
القرار الثاني الذي ميز WinRT عن COM هو أن كل عملية قد تأخذ وقتاً، مثل قراءة ملف أو طلب من الشبكة أو عرض نافذة حوار، لا توجد لها نسخة متزامنة Synchronous أصلاً، وإنما ترجع كائناً من نوع IAsyncOperation أو IAsyncAction وينتهي اسمها بـ Async، كما تشرح صفحة Asynchronous programming. والسبب درس تعلمته Microsoft من برامج Win32 التي تتجمد نوافذها لأن مطوراً قرأ ملفاً من الشبكة في خيط واجهة المستخدم UI Thread: إذا لم يكن هناك طريق متزامن فلن يسلكه أحد بالخطأ.
وكل إسقاط يحول هذا الكائن إلى أداة لغته: await في C#، وco_await في C++/WinRT. وأما في Windows PowerShell 5.1 فلا يوجد await، وهذا سبب أن سكربتات PowerShell التي تستخدم WinRT أصعب بكثير مما رأينا مع Calendar: الكلاس Calendar كل دواله متزامنة، أما فتح ملف بـ StorageFile فيحتاج أن تحول العملية إلى Task من .NET بالدالة AsTask ثم تنتظرها. ولذلك إذا كانت المهمة إدارية وتحتاج واجهات غير متزامنة كثيرة، فبرنامج C# صغير أوضح من سكربت مليء بالتحويلات.
الإسقاطات Projections: من C++/CX إلى C++/WinRT وC#/WinRT
كل ما سبق هو الطبقة الثنائية، ولا يكتب أحد تطبيقاً حقيقياً بـ lang->get_NativeName(&s) وWindowsDeleteString بعد كل سطر. فالإسقاط هو مكتبة أو مترجم يقرأ ملفات winmd ويولد لكل لغة كلاسات بأسلوبها، وقصتها نفسها فيها درس:
- C++/CX في 2012: امتداد لغوي للمترجم Visual C++ بصيغة مثل
ref new Calendar()وString^، وكان يعمل جيداً، ولكنه لم يكن C++ قياسية، فلا يعمل إلا مع مترجم Microsoft، ووثائقه اليوم في C++/CX مع توصية بالانتقال. - C++/WinRT: بدأه Kenny Kerr مشروعاً مستقلاً ثم تبنته Microsoft، وهو كما تصفه صفحة C++/WinRT إسقاط بلغة C++17 القياسية، مكتبة من ملفات الترويسة Header-only تولدها الأداة
cppwinrt.exeمن ملفات winmd، ويعمل مع أي مترجم يدعم C++17، وهو البديل الموصى به لـ C++/CX ولمكتبة WRL. وكوده مفتوح في مستودع cppwinrt. - C# من الدعم المدمج إلى C#/WinRT: في .NET Framework وحتى .NET Core 3.1 كان دعم WinRT داخل وقت التشغيل نفسه، وهو ما استخدمه PowerShell 5.1 في تجربتنا. ومع .NET 5 في 2020 خرج هذا الدعم إلى مكتبة مستقلة اسمها C#/WinRT تولد كود الإسقاط من ملفات winmd، حتى يتطور الإسقاط مع Windows دون أن ينتظر إصدارات .NET.
- JavaScript: في Windows 8 كان يمكن كتابة تطبيقات كاملة بـ HTML وJavaScript عبر إسقاط لـ WinRT، وتوقف هذا المسار لاحقاً، وبقي مثالاً على أن الإسقاط يمكن أن يكون لأي لغة.

وقد يتساءل البعض: إذا كان C++/WinRT يغلف كل شيء، فلماذا كتبنا التجربة الثانية بالواجهة الثنائية؟ والإجابة أن الغلاف يخفي عنك ما تحتاجه عند تصحيح الأخطاء Debugging: عندما يرمي C++/WinRT استثناء winrt::hresult_error برمز 0x80040154 فأنت تعرف الآن أنه خرج من RoActivateInstance، وأن المكان الذي تبحث فيه هو ActivatableClassId أو مانيفست الحزمة. ويشرح Raymond Chen في مقاله How do I access and customize the IInspectable methods of a Windows Runtime class written in C++/WinRT? كيف تصل من C++/WinRT إلى GetIids وأخواتها، لأن الإسقاط لا يعرضها كدوال عادية، ويوفر لها دوال مستقلة مثل winrt::get_interfaces.
من UWP إلى Windows App SDK: أين يكتب التطبيق اليوم؟
في 2012 كانت WinRT مربوطة بنوع واحد من التطبيقات: تطبيقات Metro التي تعمل بملء الشاشة وتأتي من المتجر وتعمل في صندوق معزول. ثم جاءت منصة Windows العامة UWP، واختصاراً لـ Universal Windows Platform، مع Windows 10 في 2015، لتعمل التطبيقات نفسها على الحاسب والجهاز اللوحي وXbox وHoloLens. ولكن أغلب مطوري سطح المكتب لم ينتقلوا، والسبب أن التطبيق المحزم في صندوق معزول لا يستطيع أن يفعل كثيراً مما تفعله برامج Win32 العادية، ولأن الواجهات الجديدة كانت مربوطة بإصدار Windows، فلا يستخدمها التطبيق إلا إذا كان المستخدم قد حدث نظامه.
والتصحيح جاء بفصل الطبقات عن النظام: مكتبة Windows App SDK، التي صدر إصدارها 1.0 في 16 نوفمبر 2021 بحسب جدول إصداراتها في Microsoft Learn، وفيها WinUI 3، تأتي كحزمة مع التطبيق نفسه وتعمل في برامج Win32 العادية، المحزمة وغير المحزمة. والأساس تحتها لم يتغير: كلاسات WinRT، وملفات winmd، وإسقاطات C++/WinRT وC#/WinRT. وسوف نروي قصة الواجهات الرسومية نفسها، من Win32 إلى WinForms وWPF وWinUI، في مقال مستقل من هذه المرحلة:
ماذا بقي من كل طبقة في Windows 11؟
| الطبقة | السنة | ما أضافته | حالها اليوم |
|---|---|---|---|
| OLE | 1990، ثم 1993 | المستندات المركبة، والسحب والإفلات بين البرامج | يعمل في Office ونسخ الكائنات بين البرامج |
| COM | 1993 | الجدول وIUnknown وGUID والتسجيل | أساس كل ما بعده، ومستكشف الملفات وDirectX مبنيان عليه |
| DCOM | 1996 | الكائن على جهاز آخر عبر RPC | يعمل، ومقوى أمنياً بشكل إلزامي منذ مارس 2023، ولا ينصح به لمشروع جديد |
| ActiveX | 1996 | كائنات COM في صفحات الويب | انتهى في المتصفح مع IE 11 في 2022 |
| COM+ | 2000 | المعاملات والتجمع والأدوار بالاعتراض | موجود للتطبيقات القديمة، وdcomcnfg ما زال يفتح |
| .NET Interop | 2002 | الأغلفة RCW وCCW بين .NET وCOM | يعمل في .NET الحديث وفي PowerShell |
| WinRT | 2012 | IInspectable والأسماء النصية وwinmd والإسقاطات | الطريقة الحالية لكل واجهة جديدة في Windows |
| Windows App SDK | 2021 | WinRT وWinUI 3 كحزمة مع التطبيق | الطريق الموصى به لتطبيقات سطح المكتب الجديدة |
ماذا نتعلم من ثلاثين سنة فوق الجدول نفسه؟
إذا نظرت إلى القصة كلها من بعيد فستجد أن Microsoft غيرت كل شيء حول COM تقريباً، وأبقت شيئين لم تلمسهما: شكل الواجهة في الذاكرة، وقاعدة أن الواجهة المنشورة لا تتغير. والتسجيل تغير من HKCR إلى ActivatableClassId إلى مانيفست الحزمة، ووصف الأنواع تغير من IDL ومكتبات الأنواع إلى winmd، وإدارة الذاكرة تغيرت من AddRef اليدوي إلى المؤشرات الذكية وجامع النفايات في الإسقاطات، والنصوص تغيرت من BSTR إلى HSTRING، ولكن برنامجاً كتب في 1998 ويستدعي كائناً عبر جدوله ما زال يعمل في Windows 11، والكائن الذي أنشأناه في المختبر من C++ دون أي مكتبة حديثة تحدث مع Windows.Globalization.dll كما يتحدث معها C# الحديث.
والدرس الأول لكل من يصمم واجهة برمجية API يستخدمها غيره: افصل العقد الثنائي عن كل ما حوله، فالعقد يجب أن يعيش عشرين سنة، وأما الأدوات حوله فتتغير كل خمس سنوات. والدرس الثاني أن كل تقنية تعرض كائناً لطرف لا تثق به، مثل DCOM على الشبكة وActiveX في المتصفح، دفعت ثمنها الأمني لسنوات، ولم يتوقف الدفع إلا عندما أغلقت الطريق نفسه. والدرس الثالث عملي جداً: عندما يظهر خطأ في أحدث طبقة، فغالباً ما تجد سببه في أقدم طبقة، ولذلك يستحق COM أن تفهمه حتى لو لم تكتب CoCreateInstance مرة واحدة في حياتك.
أخطاء شائعة Common Mistakes
- اعتبار WinRT بديلاً لـ COM: رأينا أن كائن WinRT كائن COM بواجهة أساسية إضافية، وأنه يرجع رموز HRESULT نفسها ويستخدم الكتالوج نفسه. فكل ما تعرفه عن تصحيح أخطاء COM ينفعك هنا.
- استخدام RoActivateInstance لكل كلاس: الكلاس الذي يحتاج معاملات لا يملك منشئاً فارغاً، والنتيجة
E_NOTIMPLكما في Language. انظر سمات Activatable في البيانات الوصفية قبل أن تختار. - تشغيل سكربت WinRT في PowerShell 7: لن يعرف
ContentType=WindowsRuntime، والحل powershell.exe أو مكتبة C#/WinRT في مشروع .NET. - إبقاء DCOM مفتوحاً من أجل برنامج قديم دون خطة: التقوية صارت إلزامية، والبرنامج الذي يطلب مستوى مصادقة منخفضاً سيتوقف، فاختبره قبل أن تكتشف ذلك من المستخدمين.
- مقارنة النصوص العربية التي يرجعها النظام بنص مكتوب يدوياً: علامات الاتجاه غير المرئية في NativeName تجعل المقارنة تفشل دون سبب ظاهر.
- الخلط بين التقويم الهجري وأم القرى: هما نظامان منفصلان في Windows.Globalization، وقد يختلفان بيوم في بعض الأشهر، فاختر الذي تعتمده جهتك صراحة بدل أن تترك الاختيار للإعدادات الافتراضية.
ماذا تستخدم اليوم؟ Decision Table
| ما تريد | الأنسب | والسبب |
|---|---|---|
| أن تستدعي واجهة WinRT من C++ | C++/WinRT | C++ قياسية، ومؤشرات ذكية، واستثناءات بدل HRESULT |
| أن تستدعيها من C# حديث | .NET مع C#/WinRT، أو إطار هدف Target Framework يحمل إصدار Windows | الدعم المدمج خرج من .NET 5 |
| سكربت إدارة سريع يستخدم WinRT | Windows PowerShell 5.1 | الدعم موجود دون تثبيت أي شيء |
| أتمتة Office أو مستكشف الملفات | COM عبر IDispatch | هذه البرامج تعرض كائنات COM، لا WinRT |
| واجهة رسومية لتطبيق سطح مكتب جديد | Windows App SDK وWinUI 3 | الطبقة الحالية، وتأتي مع التطبيق لا مع النظام |
| تصحيح خطأ تفعيل غامض | الواجهة الثنائية والسجل | الإسقاط يخفي من أين خرج الرمز |
تطبيق عملي Practice
- في Windows PowerShell 5.1، أنشئ
Windows.Globalization.Calendarبلغةar-EGبدلar-SA، وقارن نظام الأرقام الافتراضي واسم الشهر الميلادي. - عدل البرنامج
winmd-dumpليطبع سمات Activatable للكلاس Language، وتأكد بنفسك أنه لا يملك منشئاً فارغاً. - افتح ملفاً آخر من
C:\Windows\System32\WinMetadataمثلWindows.Storage.winmd، وابحث عن كلاس واجهاته تعيد عمليات غير متزامنة Asynchronous، ولاحظ كم واحدة منها تعيدIAsyncOperation.
حذف المختبر Cleanup
المختبر لم يكتب أي مفتاح في السجل، فلا يوجد ما يحذف هناك. والسكربت الأخير يحذف مجلد التشغيل، وملفات البناء التي كتبها dotnet build، ونسخة ملف winmd التي نسخناها للأداة objdump:
Lab folder still there: False
winmd-dump\obj still there: False
winmd copies left: 0الخلاصة Summary
- OLE وDCOM وActiveX وCOM+ و.NET Interop وWinRT طبقات فوق COM، لا بدائل له، والجدول وIUnknown ورموز HRESULT لم تتغير منذ 1993.
- كل طبقة جاءت لمشكلة محددة: المستندات المركبة، ثم الشبكة، ثم المتصفح، ثم الخدمات، ثم إدارة الذاكرة والبيانات الوصفية، ثم واجهات حديثة لكل اللغات.
- WinRT هو COM مع IInspectable وأسماء كلاسات نصية وHSTRING وملفات winmd بصيغة ECMA-335، والكلاس يسجل تحت
ActivatableClassIdأو في مانيفست الحزمة. - ملف winmd ملف PE بلا كود، يصف الأنواع فقط، ومنه تولد الإسقاطات C++/WinRT وC#/WinRT وما يراه PowerShell 5.1.
- الإسقاط يخفي المصانع ورموز الأخطاء، ومعرفة الطبقة الثنائية تحت الإسقاط هي ما يختصر عليك ساعات من تصحيح الأخطاء.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتشغيل المختبر على Windows 11 Pro 24H2 (البناء 26100.9711) بـ Windows PowerShell 5.1 وصلاحيات مستخدم عادي، وبرنامج winrt.exe مبني بـ MinGW-w64 GCC 14.2.0 في Container من alpine:3.22، وwinmd-dump مبني بـ .NET SDK 10.0.400 لإطار net8.0، دون أي تعديل في السجل.