IWbemServices::OpenNamespace-Methode (wbemcli.h)

Die IWbemServices::OpenNamespace-Methode stellt dem Aufrufer einen neuen IWbemServices-Zeiger bereit, der den angegebenen untergeordneten Namespace als Betriebskontext aufweist. Alle Vorgänge über den neuen Zeiger, z. B. die Erstellung einer Klasse oder instance, wirken sich nur auf diesen Namespace aus. Der Namespace muss ein untergeordneter Namespace des aktuellen Objekts sein, über das diese Methode aufgerufen wird.

Syntax

HRESULT OpenNamespace(
  [in]  const BSTR      strNamespace,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemServices   **ppWorkingNamespace,
  [out] IWbemCallResult **ppResult
);

Parameter

[in] strNamespace

Pfad zum Zielnamespace. Weitere Informationen finden Sie unter Erstellen von Hierarchien in WMI. Dieser Namespace kann nur relativ zum aktuellen Namespace sein, der dem IWbemServices-Schnittstellenzeiger zugeordnet ist. Dieser Parameter kann kein absoluter Pfad oder NULL sein.

[in] lFlags

Dieser Parameter kann auf 0 festgelegt werden, um dies zu einem synchronen Aufruf zu machen. Um dies zu einem semisynchronen Aufruf zu machen, legen Sie lFlags auf WBEM_FLAG_RETURN_IMMEDIATELY fest, geben Sie einen gültigen Zeiger für den ppResult-Parameter an, und dieser Aufruf wird sofort zurückgegeben. Weitere Informationen finden Sie unter Aufrufen einer Methode.

[in] pCtx

Reserviert. Dieser Parameter muss NULL sein.

[out] ppWorkingNamespace

Empfängt das -Objekt, das den neuen Namespacekontext darstellt. Der zurückgegebene Zeiger weist eine positive Verweisanzahl auf. Der Aufrufer muss release für diesen Zeiger aufrufen, wenn er nicht mehr benötigt wird. Dieser Zeiger wird auf NULL festgelegt, wenn Fehler auftreten. Wenn dieser Parameter angegeben ist, muss ppResultNULL sein.

[out] ppResult

Normalerweise NULL. Wenn nicht NULL, muss ppWorkingNamespaceNULL sein. In diesem Fall empfängt der Parameter einen Zeiger auf ein neues IWbemCallResult-Objekt . Wenn der lFlags-Parameter auf WBEM_FLAG_RETURN_IMMEDIATELY wird dieser Aufruf sofort zurückgegeben. Anschließend kann der Aufrufer regelmäßig die IWbemCallResult::GetResultServices-Methode abfragen, bis der Zeiger auf den angeforderten Namespace verfügbar ist. Dieser Parameter wird so festgelegt, dass er auf NULL zeigt, wenn ein Fehler vorliegt und kein neues Objekt zurückgegeben wird.

Hinweis Beachten Sie, dass Sie bei Verwendung dieses Parameters ppResult auf NULL festlegen müssen, bevor Sie die -Methode aufrufen. Dies ist eine COM-Regel.

 

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Bei Einem Fehler können Sie alle verfügbaren Informationen von der COM-Funktion GetErrorInfo abrufen.

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

Hinweise

Die IWbemLocator::ConnectServer-Methode kann auch verwendet werden, um denselben Namespace zu öffnen. Der einzige Unterschied besteht darin, dass Sie mit der OpenNamespace-Methode relative Objektpfade im Namespace-Parameter platzieren können, um untergeordnete Namespaces rekursiv zu öffnen. IWbemLocator::ConnectServer erfordert einen vollständigen Objektpfad. Weitere Informationen finden Sie unter Beschreiben eines WMI-Namespaceobjektpfads.

Wenn der aktuelle Namespace, der dem IWbemServices-Schnittstellenzeiger zugeordnet ist, stamm ist, ergibt die Verwendung von Default im Namespace-Parameter einen neuen Zeiger, der an den Namespace root\default-Namespace gebunden ist.

Der Namespace wird geschlossen, wenn Release aufgerufen wird und die Verweisanzahl 0 (null) erreicht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Weitere Informationen

Erstellen von Hierarchien in WMI

IWbemLocator::ConnectServer

IWbemServices

Abrufen eines Fehlercodes