إذا كتبت سطراً واحداً في PowerShell مثل New-Object -ComObject Shell.Application، أو فتحت ملف Excel من سكربت لتملأ فيه تقريراً، أو ثبتت برنامجاً أضاف خياراً جديداً في قائمة الزر الأيمن في مستكشف الملفات File Explorer، فقد استخدمت نموذج المكونات COM، واختصاراً لـ Component Object Model، دون أن تراه. وغالب الظن أنك قابلته أيضاً في شكل رسالة خطأ غامضة مثل 0x80040154 Class not registered بعد نقل برنامج قديم إلى جهاز جديد، فبحثت عن الرقم ووجدت نصائح متضاربة: سجل الملف بالأمر regsvr32، أو شغل البرنامج كمسؤول Administrator، أو ثبت نسخة 32 بت. وهذه النصائح تنجح أحياناً، ولكنها لا تخبرك أين يبحث Windows عن الكلاس، ولا لماذا يرجع الخطأ نفسه بعد شهر.
وفي هذه المرحلة من مسار Windows للمطورين تعرفنا على واجهة Win32 والمكتبات المشتركة DLL، والسؤال الطبيعي بعدها: كيف يستخدم برنامج كتب بلغة C++ كائناً Object كتب في مكتبة أخرى، بمترجم Compiler آخر، وربما بلغة أخرى تماماً مثل Visual Basic أو C#، دون أن يعرف أحدهما شيئاً عن الآخر إلا عقداً صغيراً؟ هذا بالضبط ما صمم COM من أجله في بداية التسعينات، وما زال يعمل اليوم تحت مستكشف الملفات وOffice وDirectX وPowerShell، وتحت Windows Runtime نفسه كما سيأتي في مقال لاحق.
وسوف نناقش في هذا المقال ما يلي:
- المشكلة التي حلها COM، ولماذا لا يكفي أن تصدر كلاس C++ من مكتبة DLL.
- الواجهة Interface والمعرفات GUID وIUnknown بدوالها الثلاث، وقواعد QueryInterface وعداد المراجع Reference Count.
- أين يبحث COM عن الكلاس في السجل Registry، ولماذا يستطيع المستخدم العادي أن يسجل كائناً لنفسه دون صلاحيات المسؤول.
- مختبر Lab حقيقي: خادم COM صغير كتبناه بلغة C++ دون أي إطار، وعميل Client يتتبع كل AddRef وRelease، ثلاثة أخطاء متعمدة، ومشكلة E_NOINTERFACE التي يقع فيها أغلب من يكتب أول خادم.
- كائنات من Windows نفسه: Shell.Application من C++ ومن PowerShell، واستعلام WMI للقراءة فقط.
- كيف تقرأ رموز HRESULT، والأخطاء الشائعة، وقائمة فحص قبل أن تسجل أي كائن.
وهذه بقية مقالات المرحلة، لمن أراد أن يقرأ بالترتيب:
دليلواجهة Win32 API: كيف يكلم برنامجك نظام Windows؟نقرأ واجهة Win32 ببرامج C صغيرة على Windows 11: أين يعيش كود الدوال، ولماذا يتلف الاسم العربي مع نسخة A، وكيف تقرأ GetLastError وHRESULT دون أن يخدعك رقم قديم.
دليلالمكتبات المشتركة DLL: التحميل وترتيب البحث وDLL Hellنبني مكتبة DLL صغيرة بأنفسنا ونراقب المحمل وهو يقرأ جداولها ويحملها ويستدعي DllMain، ثم نرى من أين جاء جحيم المكتبات وكيف عزله Windows بالنسخ جنباً إلى جنب.
دليلمن COM وActiveX إلى WinRT: معمارية Windows للمطوريننتتبع ثلاثين سنة من OLE وDCOM وActiveX و.NET حتى Windows Runtime، ثم نفتح WinRT على Windows 11 من PowerShell ومن C++ ومن ملف winmd لنرى أنه COM بإضافات.
دليلمن Win32 إلى WinUI: واجهات Windows عبر أربعين سنةلماذا جاءت كل تقنية لبناء واجهات Windows من Win32 إلى WinForms وWPF وWinUI، وما الذي بقي منها، مع النافذة نفسها مبنية بأربع طرق ومقاسة بالأرقام على Windows 11.لماذا وجد COM؟ المشكلة قبل الحل
لنفرض أنك كتبت مكتبة DLL فيها كلاس C++ اسمه Greeter، وتريد أن يستخدمه زميلك في برنامجه. الحل البسيط هو أن تصدر Export الكلاس نفسه من المكتبة، وتعطيه ملف الترويسة Header، فيكتب new Greeter() ويستدعي دواله. وهذا الحل يعمل ما دام الاثنان يستخدمان المترجم نفسه بالإصدار نفسه والإعدادات نفسها، ولكنه يتعطل عند أول اختلاف، والسبب أن C++ لم تحدد واجهة ثنائية ثابتة ABI، واختصاراً لـ Application Binary Interface: فكل مترجم يرمز أسماء الدوال بطريقته Name Mangling، ويرتب أعضاء الكلاس في الذاكرة بطريقته، ويختار أين يضع جدول الدوال الافتراضية. فإذا بنى زميلك برنامجه بـ MinGW وبنيت أنت المكتبة بـ Visual C++ فلن يجد الرابط Linker الدالة أصلاً، وإذا أضفت أنت عضواً جديداً إلى الكلاس في الإصدار الثاني فإن البرنامج القديم الذي يحجز الكائن بحجمه القديم سوف يكتب فوق ذاكرة لا يملكها.
والحل الثاني هو أن تتخلى عن الكلاسات، وتصدر دوال C عادية مثل greeter_create وgreeter_greet، وهذا ما تفعله أغلب واجهة Win32 حتى اليوم، لأن واجهة C الثنائية ثابتة على Windows. ولكنك خسرت هنا شيئين: لم يعد هناك مفهوم الكائن الذي يجمع البيانات مع الدوال، ولم تعد هناك طريقة يسأل بها البرنامج «هل تدعم هذه النسخة من المكتبة الميزة Feature الجديدة؟» إلا أن يحاول تحميل دالة باسمها ويرى إن كانت موجودة. ثم إن الدالة المصدرة تعني أن العميل يعرف اسم المكتبة ومكانها، فإذا أردت أن تنقل الكائن إلى عملية Process أخرى أو جهاز آخر فعليك أن تغير كل العملاء.
وجاء COM بحل وسط ذكي: الكائن لا يصدر شيئاً باسمه، وإنما يعطي العميل مؤشراً Pointer إلى جدول دوال vtable بترتيب ثابت، والجدول هو العقد. وجداول الدوال الافتراضية لها شكل واحد في الذاكرة عند كل مترجمات Windows الرئيسية، فالعقد ثنائي لا يتعلق باللغة. ولكل عقد معرف عالمي فريد GUID، واختصاراً لـ Globally Unique Identifier، طوله 128 بت، فلا يتصادم اسمان من شركتين مختلفتين. والقاعدة الأهم: الواجهة المنشورة لا تتغير أبداً، فإذا أردت إضافة دالة فأنت تنشئ واجهة جديدة بمعرف جديد، ويسأل العميل الكائن «هل تدعم هذه الواجهة؟» قبل أن يستخدمها. وبهذا تعيش النسخة القديمة من العميل مع النسخة الجديدة من الكائن، والعكس.
والتشبيه الأقرب هو مقبس الكهرباء: الجهاز لا يعرف من بنى محطة الكهرباء ولا كيف، وإنما يعرف شكل المقبس والجهد، والمحطة تستطيع أن تتغير بالكامل ما دام المقبس ثابتاً. وإذا ظهر معيار جديد للمقبس فإنه يأتي بشكل مختلف تماماً، ولا يغير أحد شكل المقبس القديم في مكانه.
المصطلحات التي تحتاجها قبل الكود
قبل المختبر نحتاج أن نتفق على ستة مصطلحات، لأن أغلب الارتباك في رسائل الخطأ يأتي من الخلط بينها:
| المصطلح | ما هو | مثاله في المختبر |
|---|---|---|
| الواجهة Interface | جدول دوال بترتيب ثابت، أول ثلاث خانات فيه دوال IUnknown | IArGreeter فيها Greet |
| معرف الواجهة IID | الـ GUID الذي يسمي الواجهة | {048FE7C1-...} |
| الكلاس CoClass | التطبيق الفعلي الذي ينشئ كائنات تدعم واجهة أو أكثر | ArGreeter داخل greeter.dll |
| معرف الكلاس CLSID | الـ GUID الذي يسمي الكلاس، ومنه يجد COM المكتبة في السجل | {4BB8DFE4-...} |
| الاسم البرمجي ProgID | اسم مقروء يشير إلى CLSID، تستخدمه لغات السكربت | ArabRoot.Greeter |
| الخادم Server | الملف الذي يسكن فيه الكلاس: مكتبة DLL داخل عملية العميل In-process، أو ملف EXE في عملية مستقلة Out-of-process، أو خادم على جهاز آخر عبر DCOM | greeter.dll، وWMI في عملية مستقلة |
وكل دالة في COM تقريباً ترجع رقماً من 32 بت اسمه HRESULT بدل أن ترمي استثناء Exception، والسبب أن الاستثناءات لا تعبر حدود اللغات والمترجمات بشكل آمن، فرقم HRESULT هو الطريقة الوحيدة التي يفهمها برنامج C وسكربت VBScript وبرنامج .NET بالطريقة نفسها. وسوف نعود إلى قراءته بالتفصيل بعد أن نرى أرقاماً حقيقية من المختبر.
تجهيز المختبر Lab: خادم COM يكتب كل خطوة
المختبر كله على جهاز Windows 11 Pro 24H2 حقيقي، في Windows PowerShell 5.1، بحساب مستخدم عادي Standard User دون رفع الصلاحيات، والتسجيل كله تحت HKCU\Software\Classes للمستخدم الحالي فقط، ويحذفه السكربت الأخير. والملفات في مجلد lab المرفق بالمقال:
greeter.h: العقد المشترك، أي واجهتان وثلاثة معرفات GUID.server.cpp: خادم COM داخل مكتبة greeter.dll، مكتوب يدوياً دون ATL ودون MIDL حتى ترى كل سطر، ويطبع سطراً عند كل QueryInterface وAddRef وRelease.client.cpp: عميل client.exe لا يعرف مسار المكتبة إطلاقاً، ويصل إليها عبر COM فقط، وله أوضاع Modes لكل تجربة.- سكربتات PowerShell مرقمة من
00إلى99، وكل سكربت يكتب مخرجه في ملفout-*.txtبعد إخفاء اسم المستخدم والجهاز.
ولا تحتاج Visual Studio لبناء الملفين، فالمترجم MinGW-w64 GCC يعمل في Container مؤقت من alpine ويحذف بعد البناء، ولا يثبت شيئاً على Windows:
cd lab
docker run --rm -v "${PWD}:/src" -w /src alpine:3.22 sh build.sh
powershell -NoProfile -ExecutionPolicy Bypass -File run.ps1والمخرج الأول يثبت البيئة: الجهاز، والصلاحيات، وحجم الملفين:
OS: Microsoft Windows 11 Pro 24H2, build 26100.9711
PowerShell: 5.1.26100.9711
Elevated (Administrator token): False
Files copied to the lab folder:
client.exe 60416 bytes
greeter.dll 157696 bytesلاحظ السطر الثالث: Elevated: False، أي أن كل ما سيأتي يعمل بصلاحيات أي موظف عادي في الشركة، وهذه نقطة سوف نعود إليها في قسم الأمان.
العقد: ملف الترويسة greeter.h
هذا هو كل ما يشترك فيه الخادم والعميل، ولا شيء غيره:
// {4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} the class (CLSID)
static const CLSID CLSID_ArGreeter = {0x4bb8dfe4, 0xbddc, 0x426a, {0x9d, 0xbe, 0xac, 0xb2, 0x05, 0x2d, 0xa5, 0xf6}};
// {048FE7C1-BD5D-4239-B672-39B63DA272F4} interface IArGreeter (IID)
static const IID IID_IArGreeter = {0x048fe7c1, 0xbd5d, 0x4239, {0xb6, 0x72, 0x39, 0xb6, 0x3d, 0xa2, 0x72, 0xf4}};
// {3F3C7195-F160-4A3D-BF49-7122B4CC034A} interface IArCounter (IID)
static const IID IID_IArCounter = {0x3f3c7195, 0xf160, 0x4a3d, {0xbf, 0x49, 0x71, 0x22, 0xb4, 0xcc, 0x03, 0x4a}};
struct IArGreeter : public IUnknown {
// Writes a greeting for name into *result (caller frees it with SysFreeString)
virtual HRESULT STDMETHODCALLTYPE Greet(const wchar_t *name, BSTR *result) = 0;
};
struct IArCounter : public IUnknown {
// How many times Greet was called on this object
virtual HRESULT STDMETHODCALLTYPE GetCount(LONG *count) = 0;
};وفي الملف أعلاه لاحظ التالي:
- ثلاثة معرفات وليس اسماً واحداً: معرف للكلاس CLSID، ومعرف لكل واجهة IID. والعميل يطلب «كائناً من الكلاس كذا، وأعطني منه الواجهة كذا»، فالسؤالان منفصلان.
- الواجهة struct فيها دوال افتراضية خالصة Pure Virtual فقط: لا توجد بيانات Data Members، ولا دالة بناء Constructor، ولا دوال غير افتراضية، لأن أي شيء غير جدول الدوال يجعل شكل الواجهة في الذاكرة متعلقاً بالمترجم.
- كل واجهة ترث من IUnknown: فأول ثلاث خانات في جدولها هي
QueryInterfaceوAddRefوReleaseدائماً، ثم دوالها هي. - STDMETHODCALLTYPE: تحدد اتفاقية الاستدعاء Calling Convention، أي من ينظف الذاكرة المؤقتة Stack ومن أين تمرر المعاملات، حتى لا يختلف عليها مترجمان.
- النص يمر كـ BSTR: سلسلة UTF-16 يسبقها طولها، يحجزها الخادم بـ
SysAllocStringويحررها العميل بـSysFreeString، لأن الاثنين يستخدمان مدير ذاكرة النظام نفسه بدل مدير ذاكرة مكتبة C الخاصة بكل منهما.
وقد يتساءل البعض: من أين جاءت هذه الأرقام الطويلة؟ والإجابة أنها ولدت مرة واحدة بالأمر [guid]::NewGuid() في PowerShell، ثم ثبتت في الملف إلى الأبد. ولا تقم بتوليد GUID جديد في كل بناء، والسبب أن المعرف هو هوية العقد، فإذا تغير صار عقداً آخر لا يعرفه أي عميل قديم.
IUnknown: ثلاث دوال يقوم عليها كل شيء
كل كائن COM يطبق IUnknown، وهي ثلاث دوال فقط تشرحها صفحة واجهة IUnknown في Microsoft Learn:
- QueryInterface: «هل تدعم الواجهة صاحبة هذا الـ IID؟ إذا نعم فأعطني مؤشراً إليها». ترجع
S_OKمع المؤشر، أوE_NOINTERFACEمع مؤشر فارغ. - AddRef: «أنا أحتفظ بنسخة من المؤشر»، فيزيد العداد واحداً.
- Release: «انتهيت من هذه النسخة»، فينقص العداد واحداً، وإذا وصل إلى الصفر فالكائن يحذف نفسه.
وهذا تطبيقها في الخادم، وهو كل ما في الأمر:
class ArGreeter : public IArGreeter, public IArCounter {
LONG m_ref = 1; LONG m_calls = 0;
public:
ArGreeter() { InterlockedIncrement(&g_objects); trace("server", L"ArGreeter %p created, ref=1", this); }
~ArGreeter() { InterlockedDecrement(&g_objects); trace("server", L"ArGreeter %p destroyed", this); }
// IUnknown: one implementation shared by both interfaces (the "identity" rule)
HRESULT STDMETHODCALLTYPE QueryInterface(REFIID iid, void **pp) override {
if (!pp) return E_POINTER;
wchar_t s[40]; StringFromGUID2(iid, s, 40);
if (iid == IID_IUnknown || iid == IID_IArGreeter) *pp = static_cast<IArGreeter *>(this);
else if (iid == IID_IArCounter) *pp = static_cast<IArCounter *>(this);
else { *pp = nullptr; trace("server", L"QueryInterface %ls -> E_NOINTERFACE", s); return E_NOINTERFACE; }
AddRef(); trace("server", L"QueryInterface %ls -> S_OK, %p", s, *pp); return S_OK;
}
ULONG STDMETHODCALLTYPE AddRef() override { LONG r = InterlockedIncrement(&m_ref); trace("server", L"AddRef -> %ld", r); return r; }
ULONG STDMETHODCALLTYPE Release() override {
LONG r = InterlockedDecrement(&m_ref); trace("server", L"Release -> %ld", r);
if (r == 0) delete this;
return r;
}وفي الكود أعلاه لاحظ التالي:
- كلاس واحد يرث الواجهتين، ولذلك يحمل الكائن في الذاكرة مؤشرين لجدولين، وسوف نرى الفرق بينهما بالأرقام بعد قليل.
- طلب IUnknown يرجع دائماً المؤشر نفسه (السطر الذي يقارن
IID_IUnknown)، وهذه قاعدة الهوية Identity التي تعتمد عليها COM لتعرف إن كان مؤشران يشيران إلى كائن واحد. - QueryInterface الناجحة تستدعي AddRef قبل أن ترجع، لأن المؤشر الذي خرج أصبح نسخة جديدة على العميل أن يحررها.
- العداد يتغير بـ InterlockedIncrement وليس
m_ref++، لأن خيطين Threads قد يستدعيان AddRef في اللحظة نفسها. - الكائن هو الذي يحذف نفسه بـ
delete this، فالعميل لا يحذف كائن COM أبداً، لأنه لا يعرف من أي مدير ذاكرة جاء ولا كم حجمه.
وتضع Microsoft قواعد ثابتة لـ QueryInterface في صفحة Rules for Implementing QueryInterface: يجب أن ترجع IUnknown نفسه دائماً، وأن تكون مجموعة الواجهات ثابتة طوال عمر الكائن، فإذا نجح طلب مرة فيجب أن ينجح كل مرة، وأن تكون العلاقة متماثلة Symmetric ومتعدية Transitive وانعكاسية Reflexive: إذا وصلت من الواجهة A إلى B فيجب أن تستطيع الرجوع من B إلى A، وإذا وصلت من A إلى B ومن B إلى C فيجب أن تصل من A إلى C مباشرة. وهذه القواعد ليست تجميلاً، فأدوات مثل الـ Proxy الذي سنراه في قسم الشقق تعتمد عليها حرفياً.
أين يبحث COM عن الكلاس؟ التسجيل في السجل Registry
العميل يعرف الـ CLSID فقط، فمن يحول هذا الرقم إلى ملف على القرص؟ الجواب هو السجل، تحت مفتاح CLSID في HKEY_CLASSES_ROOT، واختصاراً HKCR. وقبل أن نسجل أي شيء نشغل العميل لنرى ما يحدث:
> reg query HKCR\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} /s
ERROR: The system was unable to find the specified registry key or value.
> client.exe create
[client t34720] CoInitializeEx(STA) hr=0x00000000 The operation completed successfully.
[client t34720] CLSIDFromProgID hr=0x800401F3 Invalid class string
[client t34720] CoCreateInstance(IUnknown) hr=0x80040154 Class not registered
[client t34720] after CoUninitialize:
[client t34720] greeter.dll in this process: (not loaded)
(exit code 1)والمخرج أعلاه فيه خطآن مختلفان، ومن المهم أن تفرق بينهما:
0x800401F3 Invalid class stringمنCLSIDFromProgID: الاسم البرمجيArabRoot.Greeterغير موجود في السجل أصلاً، فلم يستطع COM أن يحوله إلى CLSID. واسم هذا الرمزCO_E_CLASSSTRING.0x80040154 Class not registeredمنCoCreateInstance: هنا استخدم العميل الـ CLSID مباشرة من greeter.h، فالرقم صحيح، ولكن لا يوجد له مفتاح في السجل يقول أين المكتبة. واسم هذا الرمزREGDB_E_CLASSNOTREG، وهو الرمز الذي تراه في أغلب أسئلة المنتديات.- المكتبة لم تحمل إطلاقاً: السطر الأخير يقول
(not loaded)، فلم يحاول COM أن يبحث عن greeter.dll في مجلد البرنامج ولا في PATH. وهذا فرق جوهري بين COM والتحميل العادي للمكتبات الذي شرحناه في حالات Sysinternals: هناك يبحث المحمل Loader بترتيب مجلدات، وهنا لا يوجد بحث، وإنما مسار مكتوب في السجل.
الآن نسجل الكلاس بأنفسنا. وفي الواقع يفعل هذا المثبت Installer، أو الأمر regsvr32 الذي يستدعي دالة DllRegisterServer داخل المكتبة، ولكننا نكتب القيم يدوياً حتى ترى كل واحدة منها:
$base = 'HKCU:\Software\Classes'
New-Item "$base\CLSID\$Clsid\InprocServer32" -Force | Out-Null
Set-Item "$base\CLSID\$Clsid" 'ArabRoot Greeter (lab)'
Set-Item "$base\CLSID\$Clsid\InprocServer32" (Join-Path $Run 'greeter.dll')
New-ItemProperty "$base\CLSID\$Clsid\InprocServer32" -Name ThreadingModel -Value $ThreadingModel -Force | Out-Null
New-Item "$base\CLSID\$Clsid\ProgID" -Force -Value "$ProgId" | Out-Null
New-Item "$base\$ProgId\CLSID" -Force -Value $Clsid | Out-Null
Set-Item "$base\$ProgId" 'ArabRoot Greeter (lab)'والمخرج سوف يكون كما يلي:
> reg query HKCU\Software\Classes\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} /s
HKEY_CURRENT_USER\Software\Classes\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
(Default) REG_SZ ArabRoot Greeter (lab)
HKEY_CURRENT_USER\Software\Classes\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}\InprocServer32
(Default) REG_SZ C:\lab\greeter.dll
ThreadingModel REG_SZ Apartment
HKEY_CURRENT_USER\Software\Classes\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}\ProgID
(Default) REG_SZ ArabRoot.Greeter
> reg query HKCU\Software\Classes\ArabRoot.Greeter /s
HKEY_CURRENT_USER\Software\Classes\ArabRoot.Greeter
(Default) REG_SZ ArabRoot Greeter (lab)
HKEY_CURRENT_USER\Software\Classes\ArabRoot.Greeter\CLSID
(Default) REG_SZ {4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
> reg query HKCR\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} /s
HKEY_CLASSES_ROOT\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
(Default) REG_SZ ArabRoot Greeter (lab)
HKEY_CLASSES_ROOT\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}\InprocServer32
(Default) REG_SZ C:\lab\greeter.dll
ThreadingModel REG_SZ Apartment
HKEY_CLASSES_ROOT\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}\ProgID
(Default) REG_SZ ArabRoot.Greeter
> reg query HKLM\SOFTWARE\Classes\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} /s
ERROR: The system was unable to find the specified registry key or value.وفي المخرج أعلاه لاحظ التالي:
InprocServer32: قيمته الافتراضية هي المسار الكامل للمكتبة، والاسم يعني «خادم داخل العملية، 32 بت أو أكثر» لأسباب تاريخية من أيام Windows 3.1، وما زال الاسم نفسه للمكتبات 64 بت. والمفتاح المقابل لخادم في عملية مستقلة هوLocalServer32ويشير إلى ملف EXE، كما تشرح صفحة InprocServer32.ThreadingModel: وعد من الكلاس بنوع الخيوط التي يتحمل أن تستدعيه، وهذه القيمة هي سبب أشهر مشكلة في القسم بعد القادم.ProgIDفي الاتجاهين: مفتاح باسمArabRoot.Greeterيشير إلى الـ CLSID، ومفتاح تحت الـ CLSID يشير إلى الاسم، لأن أدوات مختلفة تسأل من جهتين مختلفتين.- المفتاح ظهر في HKCR مع أننا كتبناه في HKCU، ولم يظهر في
HKLM\SOFTWARE\Classesإطلاقاً.

وهذا ما تشرحه صفحة Merged View of HKEY_CLASSES_ROOT: المفتاح HKCR عرض مدمج من HKLM\SOFTWARE\Classes لكل الجهاز، وHKCU\Software\Classes للمستخدم الحالي، وإذا وجد المفتاح نفسه في المكانين فقيمة المستخدم هي التي تظهر. وقد شرحنا الخلايا Hives والفرق بين HKCU وHKLM في مقال سجل Windows، والجديد هنا هو النتيجة العملية: أي مستخدم عادي يستطيع أن يسجل كائن COM لنفسه، ويستطيع أيضاً أن يسجل CLSID موجوداً في HKLM بمسار آخر في HKCU، فتحمل برامجه هو مكتبته هو بدل مكتبة النظام.
HKCU\Software\Classes\CLSID عن أي مفتاح يشير إلى مجلد يكتب فيه المستخدم، وأداة Autoruns التي شرحناها تعرض كثيراً من هذه المواضع.ماذا يحدث داخل CoCreateInstance؟
بعد التسجيل نشغل العميل بالوضع العادي create. والدالة CoCreateInstance تأخذ الـ CLSID وسياق التشغيل Context، ونحن نطلب CLSCTX_INPROC_SERVER أي داخل العملية، ومعرف الواجهة المطلوبة. والجزء الأول من المخرج هو ما فعله COM قبل أن ترجع الدالة:
> client.exe create
[client t43560] CoInitializeEx(STA) hr=0x00000000 The operation completed successfully.
[client t43560] CLSIDFromProgID hr=0x00000000 The operation completed successfully.
[server t43560] DllMain: greeter.dll loaded into the process
[server t43560] DllGetClassObject {4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
[server t43560] IClassFactory::CreateInstance
[server t43560] ArGreeter 000001E2FB337780 created, ref=1
[server t43560] AddRef -> 2
[server t43560] QueryInterface {00000000-0000-0000-C000-000000000046} -> S_OK, 000001E2FB337780
[server t43560] Release -> 1
[server t43560] AddRef -> 2
[server t43560] Release -> 1
[server t43560] AddRef -> 2
[server t43560] QueryInterface {00000000-0000-0000-C000-000000000046} -> S_OK, 000001E2FB337780
[server t43560] Release -> 1
[client t43560] CoCreateInstance(IUnknown) hr=0x00000000 The operation completed successfully.
والمخرج يحكي القصة بالترتيب:
- CLSIDFromProgID نجحت هذه المرة، لأن مفتاح
ArabRoot.Greeterموجود. - DllMain: قرأ COM المسار من InprocServer32 وحمل المكتبة بـ LoadLibrary، فاستدعى المحمل دالة الدخول في المكتبة. ولاحظ أن رقم الخيط
t43560هو نفسه في سطور العميل والخادم، فلا يوجد خيط آخر ولا عملية أخرى. - DllGetClassObject: الدالة المصدرة الوحيدة التي يبحث عنها COM في أي مكتبة خادم، يعطيها الـ CLSID فترجع مصنع الكلاس Class Factory.
- IClassFactory::CreateInstance: المصنع ينشئ الكائن، والعداد يبدأ من 1.
- سلسلة AddRef وRelease وQueryInterface لـ IUnknown: هذه طلبات COM نفسه داخل CoCreateInstance، ينسخ المؤشر ويحرر النسخ المؤقتة، وفي النهاية يبقى العداد 1 ويخرج المؤشر إلى العميل.
وقد يتساءل البعض: لماذا يوجد مصنع بين COM والكائن؟ لماذا لا تصدر المكتبة دالة CreateGreeter مباشرة؟ والإجابة أن المصنع نفسه كائن COM بواجهة معروفة هي IClassFactory، فيستطيع العميل أن يأخذه مرة واحدة بـ CoGetClassObject وينشئ منه ألف كائن دون أن يقرأ السجل ألف مرة، ويستطيع أن يقفل الخادم في الذاكرة بـ LockServer حتى لا يفرغ بين كائن وآخر، والأهم أن الواجهة نفسها تعمل لخادم في عملية أخرى، حيث لا توجد دالة مصدرة يمكن استدعاؤها أصلاً. فالمصنع هو ما يجعل الطريقة واحدة مهما كان مكان الخادم.
والدالة الثانية التي يبحث عنها COM في المكتبة هي DllCanUnloadNow، يسأل بها «هل ما زال أحد يستخدمك؟» قبل أن يفرغها من الذاكرة. وهذا تطبيقها مع DllGetClassObject في الخادم:
// COM calls this after it has found the DLL path in the registry (InprocServer32) and loaded the DLL
extern "C" __declspec(dllexport) HRESULT STDAPICALLTYPE DllGetClassObject(REFCLSID clsid, REFIID iid, void **pp) {
wchar_t s[40]; StringFromGUID2(clsid, s, 40);
trace("server", L"DllGetClassObject %ls", s);
if (clsid != CLSID_ArGreeter) return CLASS_E_CLASSNOTAVAILABLE;
ArGreeterFactory *f = new (std::nothrow) ArGreeterFactory(); if (!f) return E_OUTOFMEMORY;
HRESULT hr = f->QueryInterface(iid, pp); f->Release(); return hr;
}
// CoFreeUnusedLibraries asks this before unloading the DLL
extern "C" __declspec(dllexport) HRESULT STDAPICALLTYPE DllCanUnloadNow(void) {
HRESULT hr = (g_objects == 0 && g_locks == 0) ? S_OK : S_FALSE;
trace("server", L"DllCanUnloadNow -> %ls (objects=%ld)", hr == S_OK ? L"S_OK" : L"S_FALSE", g_objects);
return hr;
}واجهتان وكائن واحد: هوية الكائن Identity
الجزء التالي من المخرج هو ما فعله العميل بالمؤشر الذي حصل عليه:
[client t43560] greeter.dll in this process: C:\lab\greeter.dll
[server t43560] AddRef -> 2
[server t43560] QueryInterface {048FE7C1-BD5D-4239-B672-39B63DA272F4} -> S_OK, 000001E2FB337780
[client t43560] QI IArGreeter hr=0x00000000 The operation completed successfully.
[client t43560] Greet hr=0x00000000 The operation completed successfully.
[client t43560] result: أهلاً يا مطور Windows، هذه التحية من greeter.dll (BSTR length 48)
[server t43560] AddRef -> 3
[server t43560] QueryInterface {3F3C7195-F160-4A3D-BF49-7122B4CC034A} -> S_OK, 000001E2FB337788
[client t43560] QI IArCounter (from IArGreeter) hr=0x00000000 The operation completed successfully.
[client t43560] GetCount -> 1
[server t43560] AddRef -> 4
[server t43560] QueryInterface {00000000-0000-0000-C000-000000000046} -> S_OK, 000001E2FB337780
[server t43560] AddRef -> 5
[server t43560] QueryInterface {00000000-0000-0000-C000-000000000046} -> S_OK, 000001E2FB337780
[client t43560] identity: IArGreeter=000001E2FB337780 IArCounter=000001E2FB337788, IUnknown from each: 000001E2FB337780 000001E2FB337780 (same object)
[server t43560] Release -> 4
[server t43560] Release -> 3
[server t43560] QueryInterface {00020400-0000-0000-C000-000000000046} -> E_NOINTERFACE
[client t43560] QI IDispatch hr=0x80004002 No such interface supportedوفي المخرج أعلاه لاحظ التالي:
- Greet عملت مع النص العربي: الخادم كتب التحية في BSTR طوله 48 حرفاً بترميز UTF-16، والعميل قرأها وحولها إلى UTF-8 للطباعة. ولم يتفق الاثنان على أي ترميز غير ما يفرضه COM.
- مؤشر IArCounter يزيد 8 بايت عن مؤشر IArGreeter:
...7780و...7788. الكائن واحد، ولكن فيه مؤشران لجدولين، والمؤشر الذي تحصل عليه يعتمد على الواجهة التي طلبتها. - IUnknown من الاثنين هو
...7780نفسه: وهذا هو اختبار الهوية الوحيد الصحيح في COM. فلا تقارن مؤشري واجهتين مختلفتين لتعرف إن كانا كائناً واحداً، وإنما اطلب IUnknown من كل منهما وقارن الناتج. - طلب IDispatch رفض بـ
E_NOINTERFACE: الكائن لا يدعم الاستدعاء بالأسماء، وسوف نرى أثر هذا في PowerShell.

والصورة أعلاه هي الشكل الثنائي الذي يجعل COM مستقلاً عن اللغة: أي لغة تستطيع أن تقرأ مؤشراً، ثم تقرأ منه عنوان جدول، ثم تستدعي الخانة رقم 3 مع تمرير المؤشر نفسه كمعامل أول، تستطيع أن تستخدم الكائن. وهذا ما تفعله C++ تلقائياً، وما يفعله Visual Basic وDelphi و.NET بطرق مختلفة في الداخل، وما تفعله برامج C بكتابة g->lpVtbl->Greet(g, ...) يدوياً.
عداد المراجع Reference Count: من يملك الكائن؟
لا يوجد في COM جامع نفايات Garbage Collector، ولا يملك الكائن أحد بعينه، وإنما يملكه كل من يحمل مؤشراً إليه، والعداد يحسب عددهم. والقواعد في صفحة Rules for Managing Reference Counts تختصر في جملتين: كل مؤشر تحصل عليه من دالة (معامل خارج Out Parameter أو قيمة مرجعة) قد زيد عداده من أجلك، فعليك أن تحرره بـ Release عندما تنتهي منه. وكل مرة تنسخ فيها مؤشراً إلى مكان يعيش أطول من النسخة الأصلية (متغير عضو، أو خيط آخر)، فعليك أن تستدعي AddRef للنسخة الجديدة.
والنصف الأخير من مخرج الوضع العادي يبين التحرير:
[server t43560] Release -> 2
[server t43560] Release -> 1
[server t43560] Release -> 0
[server t43560] ArGreeter 000001E2FB337780 destroyed
[client t43560] all released; live objects in greeter.dll: 0
[server t43560] DllCanUnloadNow -> S_OK (objects=0)
[server t43560] DllMain: greeter.dll unloaded
[client t43560] greeter.dll in this process: (not loaded)
[client t43560] after CoUninitialize:
[client t43560] greeter.dll in this process: (not loaded)
(exit code 0)
والكائن حذف نفسه عند الصفر، ثم سأل COM المكتبة DllCanUnloadNow فقالت S_OK، فأفرغها من الذاكرة. والآن نخالف القاعدة عمداً مرتين، بالوضعين leak وover.
الوضع leak: نسيت Release واحدة
في هذا الوضع يحرر العميل g ولا يحرر c:
[server t42396] Release -> 1
[client t42396] forgot c->Release(); live objects in greeter.dll: 1
[server t42396] DllCanUnloadNow -> S_FALSE (objects=1)
[client t42396] greeter.dll in this process: C:\lab\greeter.dll
[server t42396] DllCanUnloadNow -> S_FALSE (objects=1)
[server t42396] DllMain: greeter.dll unloaded
[client t42396] after CoUninitialize:
[client t42396] greeter.dll in this process: (not loaded)
(exit code 0)العداد توقف عند 1، فلم يحذف الكائن، والدالة DllCanUnloadNow قالت S_FALSE مرتين، فبقيت المكتبة في الذاكرة. ثم حدث شيء مهم: عند CoUninitialize أفرغ COM المكتبة رغم وجود كائن حي فيها، ولو كان في العميل أي كود يستخدم c بعد ذلك لاستدعى عنواناً في مكتبة لم تعد موجودة. وفي برنامج صغير ينتهي بعد ثانية لن تلاحظ التسرب Leak إطلاقاً، ولكن في عملية تعيش أياماً مثل مستكشف الملفات أو خدمة Service، فكل تسرب صغير في امتداد Shell Extension يبقي المكتبة وكائناتها في الذاكرة حتى إعادة التشغيل، ولهذا يرى مسؤولو الأنظمة استهلاك ذاكرة explorer.exe يزيد يوماً بعد يوم.
الوضع over: Release أكثر من اللازم
وفي الوضع الثاني يحرر العميل g مرتين، وما زال يحمل c:
[server t35204] Release -> 0
[server t35204] ArGreeter 000002299AC98440 destroyed
[client t35204] released g twice; live objects now 0, so c=000002299AC98448 points at freed memory (not called)
[server t35204] DllCanUnloadNow -> S_OK (objects=0)
[server t35204] DllMain: greeter.dll unloaded
[client t35204] greeter.dll in this process: (not loaded)
[client t35204] after CoUninitialize:
[client t35204] greeter.dll in this process: (not loaded)
(exit code 0)هذا أخطر من التسرب: العداد وصل إلى الصفر بينما العميل ما زال يحمل المؤشر c، فحذف الكائن نفسه، ثم أفرغ COM المكتبة كلها. والمؤشر ...8448 يشير الآن إلى ذاكرة محررة داخل مكتبة غير محملة، والعميل في المختبر لا يستدعيه عمداً حتى لا يسقط البرنامج، ولكن في برنامج حقيقي يأتي الاستدعاء بعد دقائق في مكان بعيد تماماً عن الخطأ، فيسقط البرنامج بخطأ وصول للذاكرة Access Violation لا علاقة ظاهرة له بالسطر الذي سببه. وهذا النوع من الأخطاء، أي استخدام كائن بعد تحريره Use After Free، كان لسنوات أشهر مصدر لثغرات المتصفحات المبنية على كائنات COM، ومنها الثغرة CVE-2014-1776 في Internet Explorer التي نشرت لها Microsoft النشرة الأمنية 2963983 في أبريل 2014 بعد أن استغلت في هجمات حقيقية قبل وجود الإصلاح.
والحل العملي في الكود الحديث هو ألا تستدعي AddRef وRelease بيدك إطلاقاً، وأن تستخدم مؤشراً ذكياً Smart Pointer يستدعيهما في دالة البناء ودالة الهدم Destructor: Microsoft::WRL::ComPtr من مكتبة WRL، أو CComPtr من ATL، أو winrt::com_ptr من C++/WinRT. والكود في المختبر يستخدم المؤشرات الخام Raw Pointers عمداً حتى ترى كل خطوة، ولا ينصح بهذا في كود الإنتاج Production Code.
HRESULT: كيف تقرأ رقم الخطأ؟
جمع المختبر حتى الآن أربعة رموز HRESULT، وكل رمز منها ليس رقماً عشوائياً، وإنما ثلاثة حقول: البت الأعلى للخطورة Severity (1 يعني فشل، ولذلك تبدأ رموز الخطأ بـ 8)، ثم رمز المنشأ Facility في البتات 16 إلى 26، ثم رمز الخطأ نفسه في البتات الستة عشر الدنيا:
| الرمز | الاسم | المنشأ Facility | أين ظهر ومعناه |
|---|---|---|---|
0x800401F3 | CO_E_CLASSSTRING | 4 (ITF) | CLSIDFromProgID: الاسم البرمجي غير مسجل |
0x80040154 | REGDB_E_CLASSNOTREG | 4 (ITF) | CoCreateInstance: لا يوجد مفتاح للـ CLSID في HKCR |
0x80004002 | E_NOINTERFACE | 0 (NULL) | QueryInterface: الواجهة غير مدعومة، أو لا يمكن نقلها بين الشقق كما سيأتي |
0x80020006 | DISP_E_UNKNOWNNAME | 2 (DISPATCH) | GetIDsOfNames: اسم الدالة غير موجود في الكائن |
0x80070057 | E_INVALIDARG | 7 (WIN32) | رمز Win32 رقم 87 ملفوفاً في HRESULT |
والسطر الأخير مهم لأنه يعلمك قراءة أي رمز يبدأ بـ 0x8007: المنشأ 7 يعني أن الخطأ أصله رمز Win32 عادي، والأرقام الأربعة الأخيرة هي رمزه بالست عشري، فـ 0x80070005 هو الخطأ 5 أي Access is denied، و0x80070002 هو الخطأ 2 أي الملف غير موجود. ولا تحتاج أن تحفظ الجدول، فالعميل في المختبر يحول كل رمز إلى نص بالدالة FormatMessageW، وهي الدالة نفسها التي شرحناها مع GetLastError في مقال واجهة Win32، وتعرف رموز COM أيضاً. وقائمة الرموز كاملة في صفحة COM Error Codes.
S_OK، واستخدم الماكرو SUCCEEDED(hr) وFAILED(hr)، والسبب أن بعض الدوال ترجع نجاحاً آخر غير الصفر مثل S_FALSE (القيمة 1)، كما رأينا في DllCanUnloadNow: النتيجة «نجحت الدالة، والجواب لا».الشقق Apartments ونموذج الخيوط ThreadingModel
كل خيط يستخدم COM يجب أن يستدعي CoInitializeEx أولاً، ويختار فيها نوع الشقة Apartment التي يدخلها. والشقة عقد بين الخيط وCOM حول من يحق له أن يستدعي الكائن ومتى، كما تشرح صفحة Processes, Threads, and Apartments:
- الشقة أحادية الخيط STA، واختصاراً لـ Single-Threaded Apartment: فيها خيط واحد فقط، وكل استدعاء لكائن يعيش فيها يصل عبر هذا الخيط. وهي مصممة للكائنات التي لا تتحمل التزامن، مثل عناصر واجهة المستخدم التي ترتبط بنافذة وحلقة رسائل Message Loop.
- الشقة متعددة الخيوط MTA، واختصاراً لـ Multi-Threaded Apartment: فيها كل الخيوط التي اختارتها في العملية، وأي منها يستدعي الكائن مباشرة، والكائن مسؤول عن حماية نفسه بالأقفال Locks.
والقيمة ThreadingModel في السجل هي جواب الكلاس عن السؤال المقابل: أين أستطيع أن أعيش؟ Apartment يعني «في STA فقط»، وFree يعني «في MTA فقط»، وBoth يعني «في أي منهما، وأنا آمن مع الخيوط»، وغياب القيمة يعني النموذج القديم الذي يضع كل الكائنات في أول STA في العملية. وعندما لا تتوافق شقة العميل مع ما يطلبه الكائن، فإن COM لا يرفض، وإنما ينشئ الكائن في شقة مناسبة على خيط آخر، ويعطي العميل وكيلاً Proxy ينقل الاستدعاءات بين الخيطين، وتسمى عملية النقل هذه Marshaling.
المشكلة التي قابلتنا: E_NOINTERFACE من كائن يدعم الواجهة
في الوضع mta يدخل العميل شقة MTA، ويطلب الواجهة IArGreeter مباشرة من CoCreateInstance، والكلاس مسجل بـ ThreadingModel = Apartment. والكود نفسه الذي نجح قبل قليل فشل:
ThreadingModel = Apartment
> client.exe mta
[client t36656] CoInitializeEx(MTA) hr=0x00000000 The operation completed successfully.
[client t36656] apartment: multithreaded (MTA)
[server t25560] DllMain: greeter.dll loaded into the process
[server t25560] DllGetClassObject {4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
[server t25560] IClassFactory::CreateInstance
[server t25560] ArGreeter 000002BA997D5880 created, ref=1
[server t25560] AddRef -> 2
[server t25560] QueryInterface {048FE7C1-BD5D-4239-B672-39B63DA272F4} -> S_OK, 000002BA997D5880
[server t25560] Release -> 1
[server t25560] AddRef -> 2
[server t25560] Release -> 1
[server t25560] QueryInterface {ECC8691B-C1DB-4DC0-855E-65F6C551AF49} -> E_NOINTERFACE
[server t25560] QueryInterface {94EA2B94-E9CC-49E0-C0FF-EE64CA8F5B90} -> E_NOINTERFACE
[server t25560] QueryInterface {2132B005-C604-4354-85BD-8F2E24181B0C} -> E_NOINTERFACE
[server t25560] QueryInterface {00000003-0000-0000-C000-000000000046} -> E_NOINTERFACE
[server t25560] QueryInterface {0000001B-0000-0000-C000-000000000046} -> E_NOINTERFACE
... 30 more lines: COM asks the object for more marshaling interfaces, all E_NOINTERFACE ...
[server t25560] QueryInterface {4C1E39E1-E3E3-4296-AA86-EC938D896E92} -> E_NOINTERFACE
[server t25560] Release -> 2
[server t25560] AddRef -> 3
[server t25560] QueryInterface {048FE7C1-BD5D-4239-B672-39B63DA272F4} -> S_OK, 000002BA997D5880
[server t25560] QueryInterface {AF86E2E0-B12D-4C6A-9C5A-D7AA65101E90} -> E_NOINTERFACE
[server t25560] Release -> 2
[server t25560] Release -> 1
[server t25560] Release -> 0
[server t25560] ArGreeter 000002BA997D5880 destroyed
[client t36656] CoCreateInstance(IArGreeter) hr=0x80004002 No such interface supported
[client t36656] greeter.dll in this process: C:\lab\greeter.dll
[server t25560] DllCanUnloadNow -> S_OK (objects=0)
[server t25560] DllMain: greeter.dll unloaded
[client t36656] after CoUninitialize:
[client t36656] greeter.dll in this process: (not loaded)
(exit code 1)والمخرج أعلاه يستحق القراءة سطراً سطراً، لأنه يشرح المشكلة كلها:
- رقم الخيط تغير: العميل على
t36656، ولكن DllMain وإنشاء الكائن علىt25560. لم ينشئ COM الكائن في خيط العميل، وإنما أنشأ خيطاً خاصاً بشقة STA مضيفة Host STA ووضع الكائن فيه، لأن الكلاس قال إنه لا يعيش إلا في STA. - الكائن قال نعم: السطر
QueryInterface {048FE7C1-...} -> S_OKيثبت أن الكائن يدعم IArGreeter فعلاً. - ثم بدأ COM يسأل الكائن عن واجهات لم نكتبها:
{00000003-...}هي IMarshal، و{94EA2B94-...}هي IAgileObject، و{ECC8691B-...}هي INoMarshal، وغيرها. هذا COM يبحث عن طريقة لنقل المؤشر من خيط الكائن إلى خيط العميل: هل ينقل الكائن نفسه؟ هل يقول إنه يعمل من أي خيط؟ ولم يجد شيئاً. - ثم بحث عن Proxy مسجل للواجهة نفسها، فلا يوجد، لأننا لم نبن مكتبة Proxy/Stub ولم نسجلها. فحرر الكائن، وأرجع للعميل
0x80004002 No such interface supported.
والرسالة مضللة تماماً: تقول «الواجهة غير مدعومة» عن كائن قال للتو إنه يدعمها. وهذه بالضبط المشكلة التي كتب عنها Raymond Chen في مدونة The Old New Thing في مقالين: Why do I get a QueryInterface(IID_IMarshal) and then nothing? في فبراير 2004، وWhy do I get E_NOINTERFACE when creating an object that supports that interface? في ديسمبر 2004، وخلاصتهما أن عدم توافق نموذج الخيوط يجعل COM يحاول النقل، وإذا لم يجد ما يلزم للنقل فالخطأ الذي يخرج هو E_NOINTERFACE. فإذا رأيت هذا الرمز من CoCreateInstance فلا تبحث في QueryInterface أولاً، وإنما قارن شقة الخيط بقيمة ThreadingModel.
ولهذه المشكلة ثلاثة حلول، وسوف نجرب الأسهل:
- أن يدخل العميل شقة STA بدل MTA، إذا كان هذا مناسباً لبرنامجه.
- أن تبني للواجهة مكتبة Proxy/Stub من ملف IDL بالمترجم MIDL وتسجلها، أو أن تصف الواجهة في مكتبة أنواع Type Library بخاصية
oleautomationفينقلها COM بمنقل جاهز. وهذا هو الحل الصحيح إذا كان الكائن فعلاً لا يتحمل الخيوط. - أن تعلن أن الكائن آمن مع الخيوط بـ
ThreadingModel = Both، فيعيش في شقة العميل أياً كانت.
ThreadingModel = Both
> client.exe mta
[client t27928] CoInitializeEx(MTA) hr=0x00000000 The operation completed successfully.
[client t27928] apartment: multithreaded (MTA)
[server t27928] DllMain: greeter.dll loaded into the process
[server t27928] DllGetClassObject {4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
[server t27928] IClassFactory::CreateInstance
[server t27928] ArGreeter 0000023B2C888560 created, ref=1
[server t27928] AddRef -> 2
[server t27928] QueryInterface {048FE7C1-BD5D-4239-B672-39B63DA272F4} -> S_OK, 0000023B2C888560
[server t27928] Release -> 1
[server t27928] AddRef -> 2
[server t27928] Release -> 1
[server t27928] AddRef -> 2
[server t27928] QueryInterface {048FE7C1-BD5D-4239-B672-39B63DA272F4} -> S_OK, 0000023B2C888560
[server t27928] Release -> 1
[client t27928] CoCreateInstance(IArGreeter) hr=0x00000000 The operation completed successfully.
[client t27928] result: أهلاً يا MTA، هذه التحية من greeter.dll
[server t27928] Release -> 0
[server t27928] ArGreeter 0000023B2C888560 destroyed
[client t27928] greeter.dll in this process: C:\lab\greeter.dll
[server t27928] DllCanUnloadNow -> S_OK (objects=0)
[server t27928] DllMain: greeter.dll unloaded
[client t27928] after CoUninitialize:
[client t27928] greeter.dll in this process: (not loaded)
(exit code 0)الخيط واحد t27928 للعميل والخادم، ولا يوجد أي سؤال عن IMarshal، والنتيجة S_OK. ولكن هل كان هذا التغيير صحيحاً؟ ليس تماماً، والسبب أن Both وعد بأن الكائن آمن مع الخيوط، وكائننا يحمي العداد بـ InterlockedIncrement ولكنه يزيد m_calls بـ ++ عادية، فإذا استدعى خيطان Greet في اللحظة نفسها فقد يضيع أحد العدين. وفي هذا المثال الصغير لا ضرر، ولكن في كائن حقيقي فإن تغيير ThreadingModel دون مراجعة الكود يحول خطأ واضحاً اليوم إلى خطأ متقطع لا يظهر إلا تحت الضغط Load بعد شهور.

كائن من Windows نفسه: Shell.Application
كل ما سبق يعمل بالطريقة نفسها مع الكائنات التي تأتي مع Windows، وأقربها للتجربة هو كائن الواجهة الرسومية Shell.Application الذي تشرحه صفحة Shell object. وفي المختبر نستخدمه للقراءة فقط: نسأله عن المجلد الخاص رقم 0x24، وهو مجلد Windows. ولكن الطريقة هنا مختلفة، فلا يوجد عندنا ملف ترويسة للواجهة، وإنما نستخدم الواجهة العامة IDispatch:
> client.exe shell
[client t43256] CoInitializeEx(STA) hr=0x00000000 The operation completed successfully.
[client t43256] CLSIDFromProgID hr=0x00000000 The operation completed successfully.
[client t43256] Shell.Application = {13709620-C279-11CE-A49E-444553540000}
[client t43256] CoCreateInstance(IDispatch) hr=0x00000000 The operation completed successfully.
[client t43256] type info says the object is: IShellDispatch6
[client t43256] Invoke NameSpace DISPID=1610743810 hr=0x00000000
[client t43256] Invoke Title DISPID=0 hr=0x00000000
[client t43256] Invoke Self DISPID=1610809344 hr=0x00000000
[client t43256] Invoke Path DISPID=1610743812 hr=0x00000000
[client t43256] NameSpace(0x24).Title = Windows, .Self.Path = C:\Windows
[client t43256] GetIDsOfNames(NoSuchMethod) hr=0x80020006 Unknown name.
[client t43256] served in-process by: C:\Windows\System32\shell32.dll
[client t43256] after CoUninitialize:
[client t43256] greeter.dll in this process: (not loaded)
(exit code 0)
> reg query HKCR\Shell.Application\CLSID /s
HKEY_CLASSES_ROOT\Shell.Application\CLSID
(Default) REG_SZ {13709620-C279-11CE-A49E-444553540000}
> reg query HKCR\CLSID\{13709620-C279-11CE-A49E-444553540000}\InprocServer32 /s
HKEY_CLASSES_ROOT\CLSID\{13709620-C279-11CE-A49E-444553540000}\InprocServer32
(Default) REG_EXPAND_SZ %SystemRoot%\system32\shell32.dll
ThreadingModel REG_SZ Apartment
> PowerShell: New-Object -ComObject Shell.Application
NameSpace(0x24).Title = Windows, Self.Path = C:\Windows
Type seen by PowerShell: System.__ComObject
Methods PowerShell found through IDispatch and the type library: 37, e.g. AddToRecent, BrowseForFolder, CanStartStopService, CascadeWindows, ControlPanelItem, EjectPCوفي المخرج أعلاه لاحظ التالي:
- التسجيل بالشكل نفسه:
Shell.Applicationاسم برمجي يشير إلى CLSID، وتحته InprocServer32 يشير إلى shell32.dll بنموذج Apartment، كما فعلنا تماماً، والفرق أنه تحت HKLM لكل المستخدمين، والمسار بنوعREG_EXPAND_SZفيه المتغير%SystemRoot%. - الربط المتأخر Late Binding: العميل لا يعرف ترتيب الدوال، فيسأل
GetIDsOfNames("NameSpace")ويحصل على رقم DISPID هو1610743810، ثم يستدعيInvokeبهذا الرقم والمعاملات في مصفوفة من النوع VARIANT. وهذه هي الطريقة التي تعمل بها لغات السكربت كلها، وتشرحها صفحة IDispatch. - اسم غير موجود يرجع
0x80020006 Unknown nameمن GetIDsOfNames، أي قبل أي استدعاء، وهذا ما تراه في PowerShell كرسالة «لا يحتوي الكائن على دالة باسم…». - مكتبة الأنواع Type Library: الكائن عرف نفسه بـ
IShellDispatch6من خلال GetTypeInfo، وهذا ما يسمح لـ PowerShell أن يعرض 37 دالة بأسمائها في Get-Member، لأنه يقرأ وصف الواجهة من مكتبة الأنواع بدل أن يخمن. - PowerShell يرى النوع
System.__ComObject، وهو غلاف من .NET حول مؤشر COM يسمى Runtime Callable Wrapper، تشرحه صفحة Runtime Callable Wrapper.
![بطاقتان: على اليمين الربط المبكر Early Binding بالجدول vtable من C++ مع greeter.h، الاستدعاء g->Greet يذهب مباشرة إلى vtable[3] والمترجم يعرف رقم الخانة وقت البناء، وعلى اليسار الربط المتأخر Late Binding بـ IDispatch من PowerShell وVBScript وclient.exe shell، حيث GetIDsOfNames(NameSpace) تعطي DISPID = 1610743810 ثم Invoke، وتحتها أن Shell.Application ظهر فيه 37 دالة وArabRoot.Greeter صفر لأنه لا يطبق IDispatch، واسم غير موجود يعطي 0x80020006](https://arabroot.io/content/images/2026/11/com-architecture-06-binding.webp)
وماذا يرى PowerShell في كائننا نحن؟
الكائن ArabRoot.Greeter مسجل وله ProgID، فيستطيع PowerShell أن ينشئه بالأمر نفسه. والمخرج التالي من عملية PowerShell مستقلة، ولذلك ترى فيه سطور الخادم أيضاً:
> PowerShell: New-Object -ComObject ArabRoot.Greeter (our object: IUnknown only)
[server t40220] DllMain: greeter.dll loaded into the process
[server t40220] DllGetClassObject {4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6}
[server t40220] IClassFactory::CreateInstance
[server t40220] ArGreeter 00000144D93AD3E0 created, ref=1
[server t40220] AddRef -> 2
[server t40220] QueryInterface {00000000-0000-0000-C000-000000000046} -> S_OK, 00000144D93AD3E0
[server t40220] Release -> 1
[server t40220] AddRef -> 2
[server t40220] QueryInterface {00000000-0000-0000-C000-000000000046} -> S_OK, 00000144D93AD3E0
[server t40220] QueryInterface {C3FCC19E-A970-11D2-8B5A-00A0C9B7C9C4} -> E_NOINTERFACE
[server t40220] QueryInterface {B196B283-BAB4-101A-B69C-00AA00341D07} -> E_NOINTERFACE
[server t40220] QueryInterface {AF86E2E0-B12D-4C6A-9C5A-D7AA65101E90} -> E_NOINTERFACE
[server t40220] AddRef -> 3
[server t40220] QueryInterface {ECC8691B-C1DB-4DC0-855E-65F6C551AF49} -> E_NOINTERFACE
[server t40220] QueryInterface {94EA2B94-E9CC-49E0-C0FF-EE64CA8F5B90} -> E_NOINTERFACE
[server t40220] QueryInterface {00000003-0000-0000-C000-000000000046} -> E_NOINTERFACE
[server t40220] QueryInterface {00000144-0000-0000-C000-000000000046} -> E_NOINTERFACE
... 20 more QueryInterface lines from PowerShell, all E_NOINTERFACE ...
Methods PowerShell can call: 7 -> CreateObjRef, Equals, GetHashCode, GetLifetimeService, GetType, InitializeLifetimeService, ToString
... 16 more QueryInterface lines while PowerShell looks for a method named Greet ...
$g.Greet('PowerShell') -> RuntimeException: Method invocation failed because [System.__ComObject] does not contain a method named 'Greet'.
[server t40220] Release -> 0
[server t40220] ArGreeter 00000144D93AD3E0 destroyed
[server t40220] DllCanUnloadNow -> S_OK (objects=0)
[server t40220] DllMain: greeter.dll unloadedأنشأ PowerShell الكائن بنجاح، ثم بدأ يسأله: هل تطبق IProvideClassInfo ({B196B283-...}) حتى أعرف مكتبة أنواعك؟ هل تطبق IDispatch ({00020400-...})؟ هل تطبق IInspectable ({AF86E2E0-...}) فأكون أمام كائن من Windows Runtime؟ وكل الأجوبة لا، فلم يجد PowerShell أي طريقة يعرف بها أسماء الدوال، فعرض الدوال السبع التي يملكها أي كائن .NET فقط، ورفض Greet. والكائن نفسه يعمل تماماً من C++ كما رأينا، فالمشكلة ليست فيه، وإنما في أن العقد الذي كتبناه ثنائي فقط، ولغات السكربت تحتاج عقداً تستطيع أن تقرأه وقت التشغيل. ولذلك يكتب أغلب من يريد أن يستخدم كائنه من السكربت واجهة مزدوجة Dual Interface ترث IDispatch، ويرفق بها مكتبة أنواع، فيستطيع C++ أن يستدعيها بالجدول، والسكربت بالأسماء.
خادم في عملية أخرى: WMI للقراءة فقط
كل ما رأيناه حتى الآن داخل العملية، والآن نرى النوع الثاني. ونظام WMI، واختصاراً لـ Windows Management Instrumentation، مبني كله على COM، وأغلب كائناته تعيش في عمليات مستقلة. والمختبر يقرأ سطراً واحداً فقط من الصنف Win32_OperatingSystem، بالطريقة الموثقة في Getting WMI Data from the Local Computer، ثم يقرأ السطر نفسه من PowerShell:
> client.exe wmi
[client t44652] CoInitializeEx(MTA) hr=0x00000000 The operation completed successfully.
[client t44652] CoInitializeSecurity hr=0x00000000 The operation completed successfully.
[client t44652] CoCreateInstance(WbemLocator) hr=0x00000000 The operation completed successfully.
[client t44652] ConnectServer(ROOT\CIMV2) hr=0x00000000 The operation completed successfully.
[client t44652] ExecQuery hr=0x00000000 The operation completed successfully.
[client t44652] Win32_OperatingSystem: Microsoft Windows 11 Pro, build 26100
[client t44652] IWbemServices is a proxy to another process (QI IClientSecurity hr=0x00000000)
[client t44652] after CoUninitialize:
[client t44652] greeter.dll in this process: (not loaded)
(exit code 0)
> Get-CimInstance Win32_OperatingSystem | Select-Object Caption, BuildNumber
Caption : Microsoft Windows 11 Pro
BuildNumber : 26100
WmiPrvSE.exe processes now: 4 (the WMI provider host, a separate process)والفرق الذي يهمنا في هذا المخرج هو السطر السابع: IWbemServices is a proxy to another process. فالمؤشر الذي أخذه العميل من ConnectServer ليس الكائن، وإنما Proxy يدعم الواجهة IClientSecurity، وهي واجهة لا يملكها إلا وكيل لخادم في مكان آخر، يضبط بها العميل هوية الاتصال وتشفيره. وكل استدعاء لـ ExecQuery يتحول إلى رسالة عبر استدعاء الإجراءات عن بعد RPC، واختصاراً لـ Remote Procedure Call، إلى خدمة WMI وعمليات WmiPrvSE.exe التي تستضيف المزودين Providers. ولهذا السبب بالذات استدعى العميل CoInitializeSecurity قبل أي شيء، لأن الأمان بين العمليات ليس موجوداً داخل العملية الواحدة. والأمر Get-CimInstance في PowerShell يعطيك النتيجة نفسها بسطر واحد، وخلفه السلسلة نفسها. وسوف نخصص لـ WMI وCIM مقالاً مستقلاً في مرحلة برمجة النظام:
والقاعدة العامة التي يجمعها هذا القسم مع قسم الشقق هي شفافية المكان Location Transparency: العميل يكتب الكود نفسه سواء كان الكائن في الخيط نفسه، أو في خيط آخر، أو في عملية أخرى، أو على جهاز آخر عبر DCOM، وCOM هو الذي يقرر هل يعطيه مؤشراً مباشراً أو Proxy. وهذه الشفافية هي أكبر نقطة قوة في التصميم وأكبر مصدر لمفاجآته في الوقت نفسه، لأن استدعاء يأخذ نانوثانية داخل العملية قد يأخذ مللي ثانية عبر عملية أخرى، والكود لا يبين الفرق.
لماذا ما زال COM يعمل بعد ثلاثين سنة؟
قد يبدو COM من الوهلة الأولى تقنية قديمة لا تخص إلا من يصون برامج التسعينات، ولكن في الواقع فهي تحت أشياء كثيرة تستخدمها اليوم:
- مستكشف الملفات: قوائم الزر الأيمن، والمعاينة Preview، والصور المصغرة Thumbnails، كلها امتدادات Shell Extensions مكتوبة ككائنات COM داخل العملية.
- Office: كل أتمتة Automation لـ Word وExcel من PowerShell أو Python أو VBA تمر عبر IDispatch إلى خادم في عملية مستقلة.
- DirectX: واجهات Direct3D وDXGI واجهات COM ترث IUnknown، ولو لم تكتب CoCreateInstance مرة واحدة.
- Windows Runtime: الواجهات الحديثة التي تستخدمها تطبيقات Windows 10 و11 مبنية فوق COM، مع واجهة أساسية جديدة اسمها IInspectable، وهذا موضوع المقال القادم.
- .NET وPowerShell: كل
New-Object -ComObjectوكل Interop في C# يمر عبر الأغلفة التي رأيناها.
والسبب في هذا العمر الطويل هو القاعدة التي بدأنا بها: الواجهة المنشورة لا تتغير. فبرنامج كتب في 1998 ويستدعي IShellDispatch عبر IDispatch ما زال يعمل اليوم، لأن Microsoft أضافت IShellDispatch2 ثم 3 حتى 6 بجانبها بدل أن تعدلها. ولكن لهذا التصميم ثمن واضح: التسجيل في السجل يجعل التثبيت والحذف ونقل البرامج أصعب، وتعدد النسخ من الكلاس نفسه على الجهاز صعب لأن الـ CLSID واحد، ونموذج الشقق يحتاج فهماً عميقاً قبل أن تكتب كائناً يعمل مع خيوط متعددة، والعداد اليدوي مصدر دائم لأخطاء الذاكرة. ولهذه الأسباب جاءت لاحقاً بدائل مثل التسجيل دون سجل Registration-free COM بملفات Manifest، ثم .NET، ثم Windows Runtime الذي يحتفظ بالجدول وIUnknown ويغير التسجيل والأنواع والأدوات حولها.
أخطاء شائعة Common Mistakes
- تشغيل regsvr32 كمسؤول لكل مشكلة: إذا كان الخطأ
0x80040154فالمشكلة أن الكلاس غير مسجل في المكان الذي يقرأ منه البرنامج، وتسجيله في HKLM يغير الجهاز كله. وإذا كان البرنامج 32 بت على Windows 64 بت فهو يقرأ عرضاً آخر من السجل هوWOW6432Node، فتسجيل نسخة 64 بت لن يراه أصلاً. - مقارنة مؤشرين لمعرفة إن كانا كائناً واحداً: رأينا أن مؤشري IArGreeter وIArCounter مختلفان لكائن واحد. والمقارنة الصحيحة بين مؤشري IUnknown فقط.
- نسيان Release في مسار الخطأ: الكود الذي يرجع مبكراً عند فشل استدعاء ما، دون أن يحرر المؤشرات التي أخذها قبله، هو أشهر مصدر للتسرب. والمؤشرات الذكية تحل هذا تلقائياً.
- تغيير ThreadingModel لإسكات E_NOINTERFACE: رأينا أن Both أصلح الخطأ، ولكنه وعد بأمان مع الخيوط لم يكن الكود يحققه بالكامل.
- تغيير واجهة منشورة: إضافة دالة إلى IArGreeter مع الإبقاء على الـ IID نفسه يجعل العميل القديم يستدعي الخانة الخطأ، أو العميل الجديد يستدعي خانة غير موجودة في الخادم القديم، والنتيجة سقوط لا يشرح نفسه. أضف واجهة جديدة بمعرف جديد.
- نسيان CoInitializeEx في خيط جديد: كل خيط يستخدم COM يدخل شقته بنفسه، والخيط الذي لم يدخل أي شقة يحصل على
CO_E_NOTINITIALIZED(0x800401F0)، أو يدخل MTA ضمنياً إذا كانت موجودة في العملية، وهذا أسوأ لأنه يعمل أحياناً. - إعادة تشغيل المختبر فوق تسجيل قديم: في أول تشغيل كامل لسكربتات هذا المقال نجح السكربت
01-unregisteredبدل أن يفشل، لأن مفاتيح HKCU من تشغيل سابق ما زالت موجودة. ولهذا يبدأ أي اختبار لـ COM بالتحقق بـreg queryمن أن المفتاح غير موجود، وينتهي بحذفه.
عندما يظهر الرقم… من أين تبدأ؟
| ما تراه | السبب الأرجح | أين تبحث |
|---|---|---|
0x80040154 Class not registered | الـ CLSID غير مسجل للمعمارية التي يعمل بها البرنامج، أو مسجل لمستخدم آخر في HKCU | reg query HKCR\CLSID\{...} من حساب المستخدم نفسه، وWOW6432Node للبرامج 32 بت |
0x800401F3 Invalid class string | الاسم البرمجي ProgID غير موجود | reg query HKCR\<ProgID>\CLSID |
0x80004002 No such interface supported من CoCreateInstance | عدم توافق الشقة مع ThreadingModel، ولا يوجد Proxy | شقة الخيط في CoInitializeEx، وقيمة ThreadingModel، وتسجيل Proxy/Stub تحت HKCR\Interface\{IID} |
0x8007007E عند الإنشاء | المكتبة في InprocServer32 غير موجودة، أو إحدى المكتبات التي تعتمد عليها مفقودة | المسار في السجل، ثم المكتبات التي تعتمد عليها كما في مقال حالات Sysinternals |
0x80020006 Unknown name | الكائن لا يعرف هذا الاسم، أو لا يطبق IDispatch أصلاً | Get-Member على الكائن في PowerShell |
| ذاكرة العملية تزيد مع الوقت | تسرب في عداد المراجع | المكتبات التي لا تفرغ في Process Explorer، ومراجعة مسارات الخطأ في الكود |
قبل أن تسجل أي كائن COM
- قرر: هل يحتاج الكائن أن يكون لكل المستخدمين (HKLM ومثبت بصلاحيات مسؤول) أم للمستخدم الحالي فقط (HKCU)؟
- اكتب المسار الكامل للمكتبة في InprocServer32، ولا تعتمد على أن المكتبة في PATH.
- اختر ThreadingModel بحسب الكود الفعلي، لا بحسب ما يسكت الخطأ.
- إذا كان الكائن سيستخدم من السكربت، فاجعل الواجهة مزدوجة Dual وأرفق مكتبة أنواع.
- لا تجعل مجلد المكتبة قابلاً للكتابة من المستخدم العادي إذا سجلتها في HKLM، والسبب أن أي مستخدم يستطيع عندها أن يستبدل المكتبة التي تحملها برامج الجميع.
- احتفظ بسكربت حذف يزيل كل مفتاح كتبته، وتحقق منه بـ
reg query.
تطبيق عملي Practice
- أضف إلى الخادم واجهة ثالثة
IArGreeter2فيها دالةGreetFormal، بمعرف جديد، دون أن تغير IArGreeter. ثم شغل العميل القديم دون إعادة بنائه وتأكد أنه ما زال يعمل. - غير
ThreadingModelإلىFreeوشغل العميل بالوضع العاديcreateالذي يستخدم STA، وقارن رقمي الخيطين في المخرج بما رأيته في الوضعmta. - في PowerShell، أنشئ
Shell.ApplicationواستخدمGet-Memberلتجد دالة تعرض نوافذ مستكشف الملفات المفتوحة، واقرأ منها عددها فقط.
حذف المختبر Cleanup
السكربت الأخير يحذف المفتاحين اللذين كتبهما المختبر تحت HKCU، ومجلد الملفات، ثم يتحقق:
Remove-Item "HKCU:\Software\Classes\CLSID\$Clsid" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "HKCU:\Software\Classes\$ProgId" -Recurse -Force -ErrorAction SilentlyContinue
$out = @((RegQ "HKCU\Software\Classes\CLSID\$Clsid"), (RegQ "HKCU\Software\Classes\$ProgId"), (RegQ "HKCR\CLSID\$Clsid"))
Remove-Item $Run -Recurse -Force -ErrorAction SilentlyContinue
$out += "Lab folder still there: $(Test-Path $Run)"> reg query HKCU\Software\Classes\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} /s
ERROR: The system was unable to find the specified registry key or value.
> reg query HKCU\Software\Classes\ArabRoot.Greeter /s
ERROR: The system was unable to find the specified registry key or value.
> reg query HKCR\CLSID\{4BB8DFE4-BDDC-426A-9DBE-ACB2052DA5F6} /s
ERROR: The system was unable to find the specified registry key or value.
Lab folder still there: Falseوالأسطر الثلاثة تقول الشيء نفسه: لا يوجد المفتاح في HKCU، ولا الاسم البرمجي، ولا يظهر الـ CLSID في العرض المدمج HKCR. والمجلد حذف أيضاً، فلم يبق على الجهاز أي أثر للمختبر.
الخلاصة Summary
- COM عقد ثنائي: مؤشر إلى جدول دوال بترتيب ثابت، ومعرف GUID لكل واجهة وكلاس، والواجهة المنشورة لا تتغير أبداً.
- IUnknown بدوالها الثلاث أساس كل شيء: QueryInterface للسؤال عن الواجهات، وAddRef وRelease لعداد المراجع الذي يقرر متى يحذف الكائن نفسه.
- CoCreateInstance تقرأ المسار من
HKCR\CLSID\{...}\InprocServer32، وHKCR عرض مدمج تكون فيه الأولوية لـ HKCU، ولذلك يستطيع المستخدم العادي أن يسجل كائناً لنفسه، ويستطيع المهاجم أن يستغل ذلك. - Release الناقصة تسرب الكائن والمكتبة، وRelease الزائدة تترك مؤشراً إلى ذاكرة محررة، والمؤشرات الذكية تمنع الاثنين.
- E_NOINTERFACE من CoCreateInstance غالباً مشكلة شقق Apartments ونقل Marshaling، وليست مشكلة في الكائن.
- لغات السكربت تحتاج IDispatch ومكتبة أنواع، والكائن الذي لا يطبقهما يعمل من C++ ولا يظهر له شيء في PowerShell.
وفي المقال القادم بإذن الله نكمل القصة من حيث توقفنا: كيف تطور COM إلى OLE وActiveX ثم .NET، ولماذا بنت Microsoft في Windows 8 طبقة جديدة اسمها Windows Runtime فوق الجدول نفسه وIUnknown نفسها.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتشغيل المختبر على Windows 11 Pro 24H2 (البناء 26100.9711) بـ Windows PowerShell 5.1 وصلاحيات مستخدم عادي، والخادم والعميل مبنيان بـ MinGW-w64 GCC 14.2.0 في Container من alpine:3.22، والتسجيل تحت HKCU فقط وحذف في نهاية المختبر.