CWbemProviderGlue::GetEmptyInstance(MethodContext*,LPCWSTR,CInstance**,LPCWSTR)-Methode (wbemglue.h)

Artikel
08/27/2023

[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 GetEmptyInstance-Methode ruft eine einzelne nicht aufgefüllte Instanz der angegebenen Klasse ab.

Syntax

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

Parameter

pMethodContext

Zeiger auf den aktuellen Kontext.

pszClassName

Name der Klasse, deren instance zurückgegeben werden soll.

ppInstance

Zeiger auf einen instance der CInstance-Klasse, die zum Speichern des neuen instance verwendet wird. Dieser Zeiger muss vom Frameworkanbieter freigegeben werden, der GetEmptyInstance aufruft.

pszNamespace

Namespace des durch pszClassName angegebenen Klassennamens. Dieser Parameter kann NULL sein, um den Standardnamespace anzugeben, der root\cimv2 ist.

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

Der Frameworkanbieter übergibt den Namen des Anbieters an GetEmptyInstance, wodurch eine leere instance zurückgegeben wird. Diese Methode wird häufig verwendet, um eine eingebettete Objekteigenschaft aufzufüllen. Diese Methode wird in Verbindung mit CInstance::SetEmbeddedObject verwendet.

Der zweite Funktionsprototyp wird nicht empfohlen. Es wird nur bereitgestellt, um vorhandenen Code zu unterstützen.

Anforderungen


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

Freigeben über