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