CWbemProviderGlue::GetAllDerivedInstances(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,LPCWSTR)-Methode (wbemglue.h)

[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 GetAllDerivedInstances-Methode ruft eine Liste von Instanzen einer Basisklasse oder einer beliebigen untergeordneten Instanz dieser Basisklasse ab.

Syntax

HRESULT GetAllDerivedInstances(
  LPCWSTR                          pszBaseClassName,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Parameter

pszBaseClassName

Zeiger auf den Namen der Basisklasse, für die die Liste zurückgegeben werden soll.

pList

Zeiger auf die verknüpfte Liste von Instanzen, die von der von pszBaseClassName angegebenen Klasse abgeleitet wurden.

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

Namespace des Klassennamens, der durch pszBaseClassName angegeben wird. Wenn dieser Parameter NULL ist, wird der Standardnamespace root\cimv2 verwendet.

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 GetAllDerivedInstances-Methode ermöglicht Frameworkanbietern den Zugriff auf Daten von anderen Anbietern. Frameworkanbieter übergeben den Namen einer Basisklasse an GetAllDerivedInstances, das eine Liste aller Instanzen zurückgibt, die von ihr abgeleitet werden.

Die Rückgabecodes enthalten alle möglichen Rückgaben von IWbemServices::ExecQuery.

Diese Methode entspricht semantisch der Abfrage SELECT * FROM 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