CWbemProviderGlue::GetInstancePropertiesByPath-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 GetInstancePropertiesByPath-Methode ruft die durch einen bestimmten Objektpfad identifizierte instance ab, wobei nur die angegebenen Eigenschaften aufgefüllt werden. Die auffüllenden Eigenschaften werden in einem CHString-Array benannt.

Syntax

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

Parameter

pszInstancePath

Der Objektpfad zum zurückzugebenden instance. Dieser Parameter muss auf einen vollständigen Pfad verweisen.

ppInstance

Ein Zeiger auf einen Zeiger auf eine neue CInstance-instance deren Schlüssel die von pszInstancePath angegebenen sind. Der Frameworkanbieter, der die Anforderung ausführt, muss diesen Zeiger freigeben.

pMethodContext

Ein Zeiger auf den aktuellen Kontext. Ein Kontext muss 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 aus dem instance ab. Dieser Parameter darf nicht NULL sein.

[ref] csaProperties

Ein Array, das die Namen der Eigenschaften enthält, die in die neue instance kopiert werden sollen.

Rückgabewert

Gibt WBEM_S_NO_ERROR zurück, wenn der Vorgang erfolgreich war, WBEM_E_OUT_OF_MEMORY , wenn der Vorgang aufgrund fehlenden Arbeitsspeichers oder eines anderen HRESULT-Fehlercodes fehlgeschlagen ist.

Hinweise

Diese Methode verwendet teilweise instance Aktualisierungsvorgänge, um nur die angegebenen Eigenschaften des angegebenen Objekts anzufordern. Dies ist die effizienteste Methode zum Abrufen einer bestimmten instance, wenn mehr Eigenschaften als nur die Schlüssel erforderlich sind. Beachten Sie, dass nicht alle Anbieter teilweise instance Vorgänge unterstützen. In diesem Fall werden die gesamten instance (einschließlich der Schlüssel) 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 (schließen Sie FwCommon.h ein)
Bibliothek FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

Weitere Informationen

CWbemProviderGlue

GetInstanceByPath

GetInstanceKeysByPath