> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# نموذج المكونات COM من الداخل: الواجهات والتسجيل
- URL: https://arabroot.io/articles/نموذج-المكونات-com-من-الداخل-الواجهات-والتسجيل/
- Published: 2026-11-20T11:46:30.000Z
- Updated: 2026-11-20T12:41:29.000Z
- Description: نبني خادم COM صغيراً بلغة C++ ونسجله للمستخدم الحالي فقط، ونتتبع كل QueryInterface وAddRef وRelease حتى نفهم لماذا يظهر Class not registered وE_NOINTERFACE.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, Windows للمسؤولين والمطورين

إذا كتبت سطراً واحداً في 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، والأخطاء الشائعة، وقائمة فحص قبل أن تسجل أي كائن.

وهذه بقية مقالات المرحلة، لمن أراد أن يقرأ بالترتيب:

[![](https://arabroot.io/content/images/2026/11/win32-api-basics-cover-cover.webp)دليلواجهة Win32 API: كيف يكلم برنامجك نظام Windows؟نقرأ واجهة Win32 ببرامج C صغيرة على Windows 11: أين يعيش كود الدوال، ولماذا يتلف الاسم العربي مع نسخة A، وكيف تقرأ GetLastError وHRESULT دون أن يخدعك رقم قديم.](https://arabroot.io/articles/%D9%88%D8%A7%D8%AC%D9%87%D8%A9-win32-api-%D9%83%D9%8A%D9%81-%D9%8A%D9%83%D9%84%D9%85-%D8%A8%D8%B1%D9%86%D8%A7%D9%85%D8%AC%D9%83-%D9%86%D8%B8%D8%A7%D9%85-windows/)[![](https://arabroot.io/content/images/2026/11/dll-explained-cover-cover.webp)دليلالمكتبات المشتركة DLL: التحميل وترتيب البحث وDLL Hellنبني مكتبة DLL صغيرة بأنفسنا ونراقب المحمل وهو يقرأ جداولها ويحملها ويستدعي DllMain، ثم نرى من أين جاء جحيم المكتبات وكيف عزله Windows بالنسخ جنباً إلى جنب.](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B4%D8%AA%D8%B1%D9%83%D8%A9-dll-%D8%A7%D9%84%D8%AA%D8%AD%D9%85%D9%8A%D9%84-%D9%88%D8%AA%D8%B1%D8%AA%D9%8A%D8%A8-%D8%A7%D9%84%D8%A8%D8%AD%D8%AB-%D9%88dll-hell/)[![](https://arabroot.io/content/images/2026/11/com-to-winrt-cover-cover.webp)دليلمن COM وActiveX إلى WinRT: معمارية Windows للمطوريننتتبع ثلاثين سنة من OLE وDCOM وActiveX و.NET حتى Windows Runtime، ثم نفتح WinRT على Windows 11 من PowerShell ومن C++ ومن ملف winmd لنرى أنه COM بإضافات.](https://arabroot.io/articles/%D9%85%D9%86-com-%D9%88activex-%D8%A7%D9%84%D9%89-winrt-%D9%85%D8%B9%D9%85%D8%A7%D8%B1%D9%8A%D8%A9-windows-%D9%84%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/11/windows-ui-history-cover-cover.webp)دليلمن Win32 إلى WinUI: واجهات Windows عبر أربعين سنةلماذا جاءت كل تقنية لبناء واجهات Windows من Win32 إلى WinForms وWPF وWinUI، وما الذي بقي منها، مع النافذة نفسها مبنية بأربع طرق ومقاسة بالأرقام على Windows 11.](https://arabroot.io/articles/%D9%85%D9%86-win32-%D8%A7%D9%84%D9%89-winui-%D9%88%D8%A7%D8%AC%D9%87%D8%A7%D8%AA-windows-%D8%B9%D8%A8%D8%B1-%D8%A7%D8%B1%D8%A8%D8%B9%D9%8A%D9%86-%D8%B3%D9%86%D8%A9/)

## لماذا وجد 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:

```powershell
cd lab
docker run --rm -v "${PWD}:/src" -w /src alpine:3.22 sh build.sh
powershell -NoProfile -ExecutionPolicy Bypass -File run.ps1
```

والمخرج الأول يثبت البيئة: الجهاز، والصلاحيات، وحجم الملفين:

```text
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

هذا هو كل ما يشترك فيه الخادم والعميل، ولا شيء غيره:

```cpp
// {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](https://learn.microsoft.com/en-us/windows/win32/api/unknwn/nn-unknwn-iunknown?ref=arabroot.io):

- **QueryInterface**: «هل تدعم الواجهة صاحبة هذا الـ IID؟ إذا نعم فأعطني مؤشراً إليها». ترجع `S_OK` مع المؤشر، أو `E_NOINTERFACE` مع مؤشر فارغ.
- **AddRef**: «أنا أحتفظ بنسخة من المؤشر»، فيزيد العداد واحداً.
- **Release**: «انتهيت من هذه النسخة»، فينقص العداد واحداً، وإذا وصل إلى الصفر فالكائن يحذف نفسه.

وهذا تطبيقها في الخادم، وهو كل ما في الأمر:

```cpp
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](https://learn.microsoft.com/en-us/windows/win32/com/rules-for-implementing-queryinterface?ref=arabroot.io): يجب أن ترجع IUnknown نفسه دائماً، وأن تكون مجموعة الواجهات ثابتة طوال عمر الكائن، فإذا نجح طلب مرة فيجب أن ينجح كل مرة، وأن تكون العلاقة متماثلة Symmetric ومتعدية Transitive وانعكاسية Reflexive: إذا وصلت من الواجهة A إلى B فيجب أن تستطيع الرجوع من B إلى A، وإذا وصلت من A إلى B ومن B إلى C فيجب أن تصل من A إلى C مباشرة. وهذه القواعد ليست تجميلاً، فأدوات مثل الـ Proxy الذي سنراه في قسم الشقق تعتمد عليها حرفياً.

## أين يبحث COM عن الكلاس؟ التسجيل في السجل Registry

العميل يعرف الـ CLSID فقط، فمن يحول هذا الرقم إلى ملف على القرص؟ الجواب هو السجل، تحت مفتاح `CLSID` في HKEY\_CLASSES\_ROOT، واختصاراً HKCR. وقبل أن نسجل أي شيء نشغل العميل لنرى ما يحدث:

```text
> 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](https://arabroot.io/articles/%D8%AD%D8%A7%D9%84%D8%A7%D8%AA-sysinternals-%D8%AF%D8%AE%D9%88%D9%84-%D8%A8%D8%B7%D9%8A%D8%A1-%D9%88%D9%85%D8%B9%D8%A7%D9%84%D8%AC-%D9%85%D8%B4%D8%BA%D9%88%D9%84-%D9%88dll-%D9%85%D9%81%D9%82%D9%88%D8%AF/): هناك يبحث المحمل Loader بترتيب مجلدات، وهنا لا يوجد بحث، وإنما مسار مكتوب في السجل.

الآن نسجل الكلاس بأنفسنا. وفي الواقع يفعل هذا المثبت Installer، أو الأمر `regsvr32` الذي يستدعي دالة `DllRegisterServer` داخل المكتبة، ولكننا نكتب القيم يدوياً حتى ترى كل واحدة منها:

```powershell
$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)'
```

والمخرج سوف يكون كما يلي:

```text
> 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](https://learn.microsoft.com/en-us/windows/win32/com/inprocserver32?ref=arabroot.io).
- **`ThreadingModel`**: وعد من الكلاس بنوع الخيوط التي يتحمل أن تستدعيه، وهذه القيمة هي سبب أشهر مشكلة في القسم بعد القادم.
- **`ProgID` في الاتجاهين**: مفتاح باسم `ArabRoot.Greeter` يشير إلى الـ CLSID، ومفتاح تحت الـ CLSID يشير إلى الاسم، لأن أدوات مختلفة تسأل من جهتين مختلفتين.
- **المفتاح ظهر في HKCR مع أننا كتبناه في HKCU**، ولم يظهر في `HKLM\SOFTWARE\Classes` إطلاقاً.

![رسم يبين صندوقين على اليمين: HKCU\Software\Classes للمستخدم الحالي ويكتب فيه دون Administrator وفيه CLSID المختبر وArabRoot.Greeter، وHKLM\SOFTWARE\Classes لكل مستخدمي الجهاز وفيه Shell.Application وshell32.dll، وسهمان منهما إلى صندوق HKEY_CLASSES_ROOT على اليسار مكتوب فيه أنه العرض الذي يقرؤه COM ويدمج الاثنين وقيمة HKCU هي التي تظهر عند التعارض](https://arabroot.io/content/images/2026/11/com-architecture-04-hkcr.webp)

HKEY\_CLASSES\_ROOT ليس مكاناً على القرص، وإنما عرض يجمع HKCU وHKLM، والأولوية لـ HKCU.

وهذا ما تشرحه صفحة [Merged View of HKEY\_CLASSES\_ROOT](https://learn.microsoft.com/en-us/windows/win32/sysinfo/merged-view-of-hkey-classes-root?ref=arabroot.io): المفتاح HKCR عرض مدمج من `HKLM\SOFTWARE\Classes` لكل الجهاز، و`HKCU\Software\Classes` للمستخدم الحالي، وإذا وجد المفتاح نفسه في المكانين فقيمة المستخدم هي التي تظهر. وقد شرحنا الخلايا Hives والفرق بين HKCU وHKLM في [مقال سجل Windows](https://arabroot.io/articles/%D8%B3%D8%AC%D9%84-windows-registry-%D9%85%D8%A7-%D9%87%D9%88-%D9%88%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D8%AF%D9%84%D9%87-%D8%A8%D8%A7%D9%85%D8%A7%D9%86/)، والجديد هنا هو النتيجة العملية: أي مستخدم عادي يستطيع أن يسجل كائن COM لنفسه، ويستطيع أيضاً أن يسجل CLSID موجوداً في HKLM بمسار آخر في HKCU، فتحمل برامجه هو مكتبته هو بدل مكتبة النظام.

🛑

هذه الأولوية تستغلها البرمجيات الخبيثة في أسلوب يسمى اختطاف كائنات COM COM Hijacking، ويوثقه إطار MITRE ATT&CK تحت المعرف [T1546.015](https://attack.mitre.org/techniques/T1546/015/?ref=arabroot.io): يكتب المهاجم مفتاح InprocServer32 تحت HKCU لـ CLSID يستخدمه مستكشف الملفات أو برنامج يعمل مع كل دخول، فيحمل البرنامج الموثوق مكتبة المهاجم دون أي صلاحيات مسؤول ودون تعديل أي ملف في النظام. لذلك إذا راجعت جهازاً مشبوهاً فلا تكتف بـ HKLM، وابحث في `HKCU\Software\Classes\CLSID` عن أي مفتاح يشير إلى مجلد يكتب فيه المستخدم، وأداة [Autoruns](https://arabroot.io/articles/autoruns-%D9%83%D9%84-%D9%85%D8%A7-%D9%8A%D8%B9%D9%85%D9%84-%D8%AA%D9%84%D9%82%D8%A7%D8%A6%D9%8A%D8%A7-%D9%85%D8%B9-windows/) التي شرحناها تعرض كثيراً من هذه المواضع.

## ماذا يحدث داخل CoCreateInstance؟

بعد التسجيل نشغل العميل بالوضع العادي `create`. والدالة [CoCreateInstance](https://learn.microsoft.com/en-us/windows/win32/api/combaseapi/nf-combaseapi-cocreateinstance?ref=arabroot.io) تأخذ الـ CLSID وسياق التشغيل Context، ونحن نطلب `CLSCTX_INPROC_SERVER` أي داخل العملية، ومعرف الواجهة المطلوبة. والجزء الأول من المخرج هو ما فعله COM قبل أن ترجع الدالة:

```text
> 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.
```

![أربع مراحل من اليمين إلى اليسار: client.exe يعرف الـ CLSID فقط ولا يعرف مسار أي DLL، ثم السجل HKCR\CLSID\{4BB8DFE4-...} وتحته InprocServer32 بالمسار C:\lab\greeter.dll وThreadingModel = Apartment، ثم greeter.dll حيث DllGetClassObject تعطي IClassFactory ثم CreateInstance، ثم الكائن ArGreeter بعداد 1، وسهم أزرق رقم 4 يرجع المؤشر إلى client.exe](https://arabroot.io/content/images/2026/11/com-architecture-01-path.webp)

أربع خطوات خلف الاستدعاء الواحد، وبعدها لا يتدخل COM في الاستدعاءات داخل العملية.

والمخرج يحكي القصة بالترتيب:

1. **CLSIDFromProgID نجحت** هذه المرة، لأن مفتاح `ArabRoot.Greeter` موجود.
2. **DllMain**: قرأ COM المسار من InprocServer32 وحمل المكتبة بـ LoadLibrary، فاستدعى المحمل دالة الدخول في المكتبة. ولاحظ أن رقم الخيط `t43560` هو نفسه في سطور العميل والخادم، فلا يوجد خيط آخر ولا عملية أخرى.
3. **DllGetClassObject**: الدالة المصدرة الوحيدة التي يبحث عنها COM في أي مكتبة خادم، يعطيها الـ CLSID فترجع مصنع الكلاس Class Factory.
4. **IClassFactory::CreateInstance**: المصنع ينشئ الكائن، والعداد يبدأ من 1.
5. **سلسلة AddRef وRelease وQueryInterface لـ IUnknown**: هذه طلبات COM نفسه داخل CoCreateInstance، ينسخ المؤشر ويحرر النسخ المؤقتة، وفي النهاية يبقى العداد 1 ويخرج المؤشر إلى العميل.

وقد يتساءل البعض: لماذا يوجد مصنع بين COM والكائن؟ لماذا لا تصدر المكتبة دالة `CreateGreeter` مباشرة؟ والإجابة أن المصنع نفسه كائن COM بواجهة معروفة هي [IClassFactory](https://learn.microsoft.com/en-us/windows/win32/api/unknwn/nn-unknwn-iclassfactory?ref=arabroot.io)، فيستطيع العميل أن يأخذه مرة واحدة بـ `CoGetClassObject` وينشئ منه ألف كائن دون أن يقرأ السجل ألف مرة، ويستطيع أن يقفل الخادم في الذاكرة بـ `LockServer` حتى لا يفرغ بين كائن وآخر، والأهم أن الواجهة نفسها تعمل لخادم في عملية أخرى، حيث لا توجد دالة مصدرة يمكن استدعاؤها أصلاً. فالمصنع هو ما يجعل الطريقة واحدة مهما كان مكان الخادم.

والدالة الثانية التي يبحث عنها COM في المكتبة هي `DllCanUnloadNow`، يسأل بها «هل ما زال أحد يستخدمك؟» قبل أن يفرغها من الذاكرة. وهذا تطبيقها مع DllGetClassObject في الخادم:

```cpp
// 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

الجزء التالي من المخرج هو ما فعله العميل بالمؤشر الذي حصل عليه:

```text
[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.

![رسم من ثلاثة أجزاء: على اليمين ما يملكه العميل، المؤشر IArGreeter* g بالقيمة 0x...7780 والمؤشر IArCounter* c بالقيمة 0x...7788 والفرق 8 بايت، وفي الوسط الكائن في الذاكرة بأربع خانات: +0 مؤشر جدول IArGreeter و+8 مؤشر جدول IArCounter و+16 m_ref و+20 m_calls، وعلى اليسار جدولا الدوال: QueryInterface وAddRef وRelease ثم Greet في الأول، وQueryInterface وAddRef وRelease ثم GetCount في الثاني](https://arabroot.io/content/images/2026/11/com-architecture-02-vtable.webp)

كل واجهة مؤشر إلى جدول، وأول ثلاث خانات في كل جدول هي IUnknown، والهوية هي مؤشر IUnknown.

والصورة أعلاه هي الشكل الثنائي الذي يجعل COM مستقلاً عن اللغة: أي لغة تستطيع أن تقرأ مؤشراً، ثم تقرأ منه عنوان جدول، ثم تستدعي الخانة رقم 3 مع تمرير المؤشر نفسه كمعامل أول، تستطيع أن تستخدم الكائن. وهذا ما تفعله C++ تلقائياً، وما يفعله Visual Basic وDelphi و.NET بطرق مختلفة في الداخل، وما تفعله برامج C بكتابة `g->lpVtbl->Greet(g, ...)` يدوياً.

## عداد المراجع Reference Count: من يملك الكائن؟

لا يوجد في COM جامع نفايات Garbage Collector، ولا يملك الكائن أحد بعينه، وإنما يملكه كل من يحمل مؤشراً إليه، والعداد يحسب عددهم. والقواعد في صفحة [Rules for Managing Reference Counts](https://learn.microsoft.com/en-us/windows/win32/com/rules-for-managing-reference-counts?ref=arabroot.io) تختصر في جملتين: كل مؤشر تحصل عليه من دالة (معامل خارج Out Parameter أو قيمة مرجعة) قد زيد عداده من أجلك، فعليك أن تحرره بـ Release عندما تنتهي منه. وكل مرة تنسخ فيها مؤشراً إلى مكان يعيش أطول من النسخة الأصلية (متغير عضو، أو خيط آخر)، فعليك أن تستدعي AddRef للنسخة الجديدة.

والنصف الأخير من مخرج الوضع العادي يبين التحرير:

```text
[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)
```

![رسم خطي لقيمة العداد عبر 16 خطوة: داخل CoCreateInstance يتذبذب بين 1 و2 سبع مرات، ثم داخل client.exe يصعد مع QI IArGreeter وQI IArCounter وطلبي IUnknown إلى 5، ثم ينزل مع كل Release حتى يصل إلى 0 بعد g->Release وتظهر النقطة الأخيرة باللون الأحمر، وتحته سطر أحمر يقول إن في leak توقف العداد عند 1 ولم يحذف الكائن، وفي over وصل إلى 0 والمؤشر c ما زال مع العميل](https://arabroot.io/content/images/2026/11/com-architecture-03-refcount.webp)

العداد في الوضع العادي من المخرج نفسه: كل QueryInterface ناجحة تزيده، وكل Release تنقصه، والكائن يحذف نفسه عند الصفر.

والكائن حذف نفسه عند الصفر، ثم سأل COM المكتبة `DllCanUnloadNow` فقالت `S_OK`، فأفرغها من الذاكرة. والآن نخالف القاعدة عمداً مرتين، بالوضعين `leak` و`over`.

### الوضع leak: نسيت Release واحدة

في هذا الوضع يحرر العميل g ولا يحرر c:

```text
[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:

```text
[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](https://learn.microsoft.com/en-us/security-updates/securityadvisories/2014/2963983?ref=arabroot.io) في أبريل 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](https://learn.microsoft.com/en-us/windows/win32/com/com-error-codes-1?ref=arabroot.io).

💡

لا تتحقق من النجاح بمقارنة الرقم بـ `S_OK`، واستخدم الماكرو `SUCCEEDED(hr)` و`FAILED(hr)`، والسبب أن بعض الدوال ترجع نجاحاً آخر غير الصفر مثل `S_FALSE` (القيمة 1)، كما رأينا في DllCanUnloadNow: النتيجة «نجحت الدالة، والجواب لا».

## الشقق Apartments ونموذج الخيوط ThreadingModel

كل خيط يستخدم COM يجب أن يستدعي `CoInitializeEx` أولاً، ويختار فيها نوع الشقة Apartment التي يدخلها. والشقة عقد بين الخيط وCOM حول من يحق له أن يستدعي الكائن ومتى، كما تشرح صفحة [Processes, Threads, and Apartments](https://learn.microsoft.com/en-us/windows/win32/com/processes--threads--and-apartments?ref=arabroot.io):

- **الشقة أحادية الخيط 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`. والكود نفسه الذي نجح قبل قليل فشل:

```text
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?](https://devblogs.microsoft.com/oldnewthing/20040220-00/?p=40533&ref=arabroot.io) في فبراير 2004، و[Why do I get E\_NOINTERFACE when creating an object that supports that interface?](https://devblogs.microsoft.com/oldnewthing/20041213-00/?p=37043&ref=arabroot.io) في ديسمبر 2004، وخلاصتهما أن عدم توافق نموذج الخيوط يجعل COM يحاول النقل، وإذا لم يجد ما يلزم للنقل فالخطأ الذي يخرج هو E\_NOINTERFACE. فإذا رأيت هذا الرمز من CoCreateInstance فلا تبحث في QueryInterface أولاً، وإنما قارن شقة الخيط بقيمة ThreadingModel.

ولهذه المشكلة ثلاثة حلول، وسوف نجرب الأسهل:

1. أن يدخل العميل شقة STA بدل MTA، إذا كان هذا مناسباً لبرنامجه.
2. أن تبني للواجهة مكتبة Proxy/Stub من ملف IDL بالمترجم MIDL وتسجلها، أو أن تصف الواجهة في مكتبة أنواع Type Library بخاصية `oleautomation` فينقلها COM بمنقل جاهز. وهذا هو الحل الصحيح إذا كان الكائن فعلاً لا يتحمل الخيوط.
3. أن تعلن أن الكائن آمن مع الخيوط بـ `ThreadingModel = Both`، فيعيش في شقة العميل أياً كانت.

```text
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 بعد شهور.

![ثلاث بطاقات: على اليمين STA + Apartment والعميل والكائن متصلان بسهم أخضر مباشر ورقما الخيطين t43560 = t43560 والنتيجة مؤشر مباشر S_OK، وفي الوسط بطاقة حمراء MTA + Apartment وبين العميل والكائن مربع Proxy بخط متقطع ورقما الخيطين t36656 ≠ t25560 والنتيجة يلزم Proxy ولا يوجد 0x80004002، وعلى اليسار MTA + Both وسهم مباشر ورقما الخيطين t27928 = t27928 والنتيجة S_OK](https://arabroot.io/content/images/2026/11/com-architecture-05-apartments.webp)

الكود نفسه ثلاث مرات: الذي تغير هو شقة الخيط وقيمة ThreadingModel في السجل، ورقم الخيط يكشف أين أنشئ الكائن.

## كائن من Windows نفسه: Shell.Application

كل ما سبق يعمل بالطريقة نفسها مع الكائنات التي تأتي مع Windows، وأقربها للتجربة هو كائن الواجهة الرسومية Shell.Application الذي تشرحه صفحة [Shell object](https://learn.microsoft.com/en-us/windows/win32/shell/shell?ref=arabroot.io). وفي المختبر نستخدمه للقراءة فقط: نسأله عن المجلد الخاص رقم `0x24`، وهو مجلد Windows. ولكن الطريقة هنا مختلفة، فلا يوجد عندنا ملف ترويسة للواجهة، وإنما نستخدم الواجهة العامة IDispatch:

```text
> 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](https://learn.microsoft.com/en-us/windows/win32/api/oaidl/nn-oaidl-idispatch?ref=arabroot.io).
- **اسم غير موجود** يرجع `0x80020006 Unknown name` من GetIDsOfNames، أي قبل أي استدعاء، وهذا ما تراه في PowerShell كرسالة «لا يحتوي الكائن على دالة باسم…».
- **مكتبة الأنواع Type Library**: الكائن عرف نفسه بـ `IShellDispatch6` من خلال GetTypeInfo، وهذا ما يسمح لـ PowerShell أن يعرض 37 دالة بأسمائها في Get-Member، لأنه يقرأ وصف الواجهة من مكتبة الأنواع بدل أن يخمن.
- **PowerShell يرى النوع `System.__ComObject`**، وهو غلاف من .NET حول مؤشر COM يسمى Runtime Callable Wrapper، تشرحه صفحة [Runtime Callable Wrapper](https://learn.microsoft.com/en-us/dotnet/standard/native-interop/runtime-callable-wrapper?ref=arabroot.io).

![بطاقتان: على اليمين الربط المبكر 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 مستقلة، ولذلك ترى فيه سطور الخادم أيضاً:

```text
> 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](https://learn.microsoft.com/en-us/windows/win32/wmisdk/example--getting-wmi-data-from-the-local-computer?ref=arabroot.io)، ثم يقرأ السطر نفسه من PowerShell:

```text
> 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 ويغير التسجيل والأنواع والأدوات حولها.

[![](https://arabroot.io/content/images/2026/11/com-to-winrt-cover-cover.webp)دليلمن COM وActiveX إلى WinRT: معمارية Windows للمطوريننتتبع ثلاثين سنة من OLE وDCOM وActiveX و.NET حتى Windows Runtime، ثم نفتح WinRT على Windows 11 من PowerShell ومن C++ ومن ملف winmd لنرى أنه COM بإضافات.](https://arabroot.io/articles/%D9%85%D9%86-com-%D9%88activex-%D8%A7%D9%84%D9%89-winrt-%D9%85%D8%B9%D9%85%D8%A7%D8%B1%D9%8A%D8%A9-windows-%D9%84%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86/)

## أخطاء شائعة 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](https://arabroot.io/articles/process-explorer-%D9%85%D8%AF%D9%8A%D8%B1-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%83%D9%85%D8%A7-%D9%8A%D8%AC%D8%A8-%D8%A7%D9%86-%D9%8A%D9%83%D9%88%D9%86/)، ومراجعة مسارات الخطأ في الكود |

## قبل أن تسجل أي كائن COM

1. قرر: هل يحتاج الكائن أن يكون لكل المستخدمين (HKLM ومثبت بصلاحيات مسؤول) أم للمستخدم الحالي فقط (HKCU)؟
2. اكتب المسار الكامل للمكتبة في InprocServer32، ولا تعتمد على أن المكتبة في PATH.
3. اختر ThreadingModel بحسب الكود الفعلي، لا بحسب ما يسكت الخطأ.
4. إذا كان الكائن سيستخدم من السكربت، فاجعل الواجهة مزدوجة Dual وأرفق مكتبة أنواع.
5. لا تجعل مجلد المكتبة قابلاً للكتابة من المستخدم العادي إذا سجلتها في HKLM، والسبب أن أي مستخدم يستطيع عندها أن يستبدل المكتبة التي تحملها برامج الجميع.
6. احتفظ بسكربت حذف يزيل كل مفتاح كتبته، وتحقق منه بـ `reg query`.

## تطبيق عملي Practice

1. أضف إلى الخادم واجهة ثالثة `IArGreeter2` فيها دالة `GreetFormal`، بمعرف جديد، دون أن تغير IArGreeter. ثم شغل العميل القديم دون إعادة بنائه وتأكد أنه ما زال يعمل.
2. غير `ThreadingModel` إلى `Free` وشغل العميل بالوضع العادي `create` الذي يستخدم STA، وقارن رقمي الخيطين في المخرج بما رأيته في الوضع `mta`.
3. في PowerShell، أنشئ `Shell.Application` واستخدم `Get-Member` لتجد دالة تعرض نوافذ مستكشف الملفات المفتوحة، واقرأ منها عددها فقط.

## حذف المختبر Cleanup

السكربت الأخير يحذف المفتاحين اللذين كتبهما المختبر تحت HKCU، ومجلد الملفات، ثم يتحقق:

```powershell
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)"
```

```text
> 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 فقط وحذف في نهاية المختبر.