Dllgetmonitorobject-Rückruffunktion

Die dllgetmonitorobject -Funktion muss vom Monitor implementiert werden. Die mcsvc ruft diese Funktion auf, um eine Instanz des Monitors zu erstellen.

Syntax

HRESULT DllGetMonitorObject(
  _In_  REFIID riid,
  _Out_ LPVOID *ppObj
);

Parameter

riid [ in]

UUID der unten gezeigten Monitore, wie in der Header Datei "imonitor. h" definiert. Wenn eine ungültige UUID bereitgestellt wird, schlägt die Funktion fehl, und der Monitor muss E _ nointerface zurückgeben.

IID_IMonitor

ppobj [ vorgenommen]

Zeiger auf einen Zeiger, der die in riid angeforderte Schnittstelle empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert S _ OK (entspricht noError).

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein Fehlercode. Wenn ein Fehlercode zurückgegeben wird, erstellt das mcsvc das Monitor Objekt nicht, und die IUnknown:: Release -Methode wird nicht für den Schnittstellen Zeiger aufgerufen.

Bemerkungen

Die dllgetmonitorobject -Funktion wird jedes Mal aufgerufen, wenn der mcsvc versucht, eine Instanz des Monitors zu erstellen. Diese Funktion weist absichtlich eine starke Ähnlichkeit mit der gängigeren DllGetClassObject -Funktion auf. Der Hauptunterschied besteht darin, dass eine CLSID nicht an dllgetmonitorobject übermittelt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Netmon. h