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