IUnsecuredApartment::CreateObjectStub-Methode (wbemcli.h)

Artikel
08/27/2023

Die CreateObjectStub-Methode erstellt eine Objektweiterleitungssenke, um den Empfang asynchroner Aufrufe von der Windows-Verwaltung zu unterstützen. Diese Funktion bindet eine ungesicherte Objektsenke an eine lokale Objektsenke, sodass die COM-Sicherheit den asynchronen Abruf von CIM-Objekten nicht beeinträchtigt. Da die COM-Sicherheit umgangen wird, wird davon ausgegangen, dass der Windows-Remoteverwaltungsserver eine vertrauenswürdige Komponente ist.

Das allgemeine Paradigma ist, dass die ursprüngliche Implementierung von IWbemObjectSink im Clientprozess nicht direkt in asynchronen Aufrufen von IWbemServices verwendet wird. Stattdessen werden sowohl die ursprüngliche Implementierung als auch ein Ersatzobjekt erstellt, aneinander gebunden, und dann wird das Ersatzobjekt in den asynchronen Methoden von IWbemServices verwendet.

Syntax

HRESULT CreateObjectStub(
  [in]  IUnknown *pObject,
  [out] IUnknown **ppStub
);

Parameter

[in] pObject

Zeiger auf die prozessinterne Implementierung von IWbemObjectSink des Clients.

[out] ppStub

Empfängt einen Zeiger auf ein Ersatzobjekt, das in asynchronen IWbemServices-Aufrufen verwendet werden soll. Der Benutzer erhält einen IUnknown-Zeiger und muss QueryInterface für IID_WbemObjectSink aufrufen, bevor er dieses Objekt in asynchronen IWbemServices-Aufrufen verwendet.

Rückgabewert

Diese Methode gibt standardmäßige COM-Fehlercodes für QueryInterface zurück. Es gibt S_OK zurück, wenn der Aufruf erfolgreich ist. Wenn der Aufruf fehlschlägt, weil die angeforderte Schnittstelle nicht unterstützt wurde, gibt die Methode E_NOINTERFACE zurück.

COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass die Remoteverbindung mit der Windows-Verwaltung verloren geht.

Hinweise

Hinweis Da der Rückruf an die Senke möglicherweise nicht auf der gleichen Authentifizierungsebene zurückgegeben wird, die der Client benötigt, wird empfohlen, semisynchron anstelle der asynchronen Kommunikation zu verwenden. Weitere Informationen finden Sie unter Aufrufen einer Methode.

Beispiele

Ein vollständiges Beispiel zur Verwendung der IUnsecuredApartment-Schnittstelle finden Sie unter Beispiel: Empfangen von Ereignisbenachrichtigungen über WMI.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Unsecapp.exe