CWbemProviderGlue::GetInstanceKeysByPath-Methode (wbemglue.h)

  • Artikel

[Die CWbemProviderGlue-Klasse ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und werden keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar sein, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die GetInstanceKeysByPath-Methode ruft die durch einen bestimmten Objektpfad identifizierte instance ab, wobei nur die Schlüsseleigenschaften aufgefüllt werden.

Syntax

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parameter

pszInstancePath

Ein Objektpfad zum zurückzugebenden instance.

ppInstance

Ein Zeiger auf einen Zeiger auf einen neuen CInstance-instance dessen Schlüssel die im pszInstancePath angegebenen schlüssel sind. Der Frameworkanbieter, der die Anforderung ausführt, muss diesen Zeiger freigeben.

pMethodContext

Ein Zeiger auf den aktuellen Kontext. Es muss ein Kontext bereitgestellt werden, um Deadlocks zu verhindern. Verwenden Sie entweder den Kontext, der von Provider::EnumerateInstances oder Provider::ExecQuery an den Anbieter übergeben wird, oder rufen Sie ihn mithilfe von CInstance::GetMethodContext von der instance ab. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Gibt WBEM_S_NO_ERROR zurück, wenn der Vorgang erfolgreich war, WBEM_E_OUT_OF_MEMORY , wenn der Vorgang aufgrund von Arbeitsspeichermangel oder einem anderen HRESULT-Fehlercode fehlgeschlagen ist.

Hinweise

Diese Methode verwendet teilweise instance Aktualisierungsvorgänge, um nur die Schlüsseleigenschaften des angegebenen Objekts anzufordern. Dies ist die effizienteste Möglichkeit, das Vorhandensein eines bestimmten Objekts zu überprüfen. Beachten Sie, dass nicht alle Anbieter teilweise instance Vorgänge unterstützen. In diesem Fall wird der gesamte instance aufgefüllt. Weitere Informationen finden Sie unter Unterstützen von Partial-Instance-Vorgängen.

In der aktuellen Version des Anbieterframeworks muss pszInstancePath als instance Pfad auf demselben Computer aufgelöst werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemglue.h (einschließlich FwCommon.h)
Bibliothek FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

Weitere Informationen

CWbemProviderGlue

GetInstanceByPath

GetInstancePropertiesByPath