IWbemContext::GetNames-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemContext::GetNames-Methode gibt eine SAFEARRAY-Struktur aller Namen der benannten Kontextwerte zurück. Nachdem alle Namen bekannt sind, kann GetValue für jeden Namen aufgerufen werden, um den Wert abzurufen. Mit dieser Technik können Sie auf die Kontextwerte zugreifen, die sich vom Aufrufen der BeginEnumeration-, Next- und EndEnumeration-Methoden unterscheiden.

Syntax

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] pNames

Dieser Parameter kann nicht NULL sein, muss aber beim Eintrag auf NULL zeigen. Wenn kein Fehler zurückgegeben wird, empfängt pstrNames beim Beenden einen Zeiger auf eine neue SAFEARRAY-Struktur vom Typ VT_BSTR alle Kontextwertnamen enthält. Der Aufrufer muss SafeArrayDestroy auf dem zurückgegebenen Zeiger aufrufen, wenn das Array nicht mehr benötigt wird. Wenn ein Fehlercode zurückgegeben wird, bleibt der Zeiger unverändert.

Hinweis Wenn im Objekt keine benannten Werte vorhanden sind, ist der Aufruf erfolgreich und gibt ein Array der Länge 0 zurück.

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.

Hinweise

Weitere Informationen zur Verwendung von SAFEARRAY-Strukturen von BSTR-Werten finden Sie unter Abrufen eines Teils einer WMI-Instanz.

Anforderungen


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	Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Weitere Informationen

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue

Share via