CWbemProviderGlue::GetInstancesByQuery (wbemglue.h)

Artikel
03/03/2024

[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 GetInstancesByQuery-Methode ruft eine Liste von Instanzen ab, die einer bestimmten Abfrage entsprechen.

Syntax

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Parameter

query

Auszuführende Abfrage.

pList

Verknüpfte Liste der Instanzen, die mit der durch Abfrage angegebenen Abfrage übereinstimmen.

pMethodContext

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.

pszNamespace

Zeiger auf den Namespace, der die -Instanzen enthält. Bei NULL wird der Standardnamespace root\cimv2 verwendet.

Rückgabewert

Die -Methode gibt WBEM_S_NO_ERROR zurück, wenn der Vorgang erfolgreich war, WBEM_E_FAILED , wenn der Vorgang fehlgeschlagen ist, oder einen anderen HRESULT-Fehlercode .

Hinweise

Die GetInstancesByQuery-Methode ermöglicht Frameworkanbietern den Zugriff auf Daten von anderen Anbietern, ohne einen WMI-API-Aufruf ausführen zu müssen. Frameworkanbieter übergeben eine Abfrage an GetInstancesByQuery, die die entsprechenden Instanzen zurückgibt.

Geben Sie aus Leistungsgründen beim Aufrufen dieser Funktion nur die Eigenschaften an, die Sie benötigen (geben Sie z. B. " SELECT-Name" anstelle von "SELECT *") an.

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

Freigeben über