CWbemProviderGlue::GetAllInstances-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 GetAllInstances-Methode ruft eine Liste von Instanzen ab, die von einer bestimmten Klasse zurückgegeben werden.

Syntax

HRESULT GetAllInstances(
  LPCWSTR                          pszClassName,
  TRefPointerCollection<CInstance> *pList,
  LPCWSTR                          pszNamespace,
  MethodContext                    *pMethodContext
);

Parameter

pszClassName

Name der Klasse, für die eine Liste von Instanzen zurückgegeben werden soll.

pList

Verknüpfte Liste der Instanzen, die vom von pszClassName angegebenen Anbieter unterstützt werden.

pszNamespace

Namespace des durch pszClassName angegebenen Anbieters. Dieser Parameter kann NULL sein, um den Standardnamespace anzugeben, der "Root\CIMv2" lautet.

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.

Rückgabewert

Die Methode 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

Die GetAllInstances-Methode ermöglicht Frameworkanbietern den Zugriff auf Daten von einem anderen Anbieter, ohne einen WMI-API-Aufruf ausführen zu müssen. Frameworkanbieter übergeben den Namen des Anbieters an GetAllInstances, der eine Liste aller Instanzen zurückgibt, die der Anbieter unterstützt.

Diese Methode entspricht semantisch der Abfrage SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName.

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