CInstance-Klasse (instance.h)

[Die CInstance-Klasse ist Teil des WMI-Anbieterframeworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die CInstance-Klasse wird verwendet, um die Werte der Eigenschaften abzurufen und zu aktualisieren, die für die vom WMI-Anbieterframework unterstützten Instanzen definiert sind. Die CInstance-Klasse bietet auch Zugriff auf die Implementierung der CInstance-Schnittstelle durch das Anbieterframework.

Es wird nicht erwartet, dass Anbieterautoren von dieser Klasse abgeleitet werden müssen. Verwenden Sie Provider::CreateNewInstance, um eine instance dieser Klasse zu erstellen.

CInstance verfügt über folgende Membertypen:

Methode	Beschreibung
Commit	Gibt den aktuellen instance an WMI zurück.
Getbool	Ruft eine boolesche Eigenschaft ab.
Getbyte	Ruft eine BYTE-kompatible Eigenschaft ab.
GetCHString	Ruft eine Zeichenfolgeneigenschaft ab.
GetClassObjectInterface	Gibt einen IWbemClassObject-Schnittstellenzeiger zurück.
GetDateTime	Gibt eine datetime-Eigenschaft zurück.
Getdouble	Ruft eine DOUBLE-Eigenschaft ab.
GetDWORD	Ruft eine DWORD-Eigenschaft ab.
GetEmbeddedObject	Ruft eine eingebettete CInstance-Eigenschaft ab.
GetMethodContext	Gibt einen Zeiger auf ein MethodContext-Objekt zurück.
Getstatus	Bestimmt, ob eine Eigenschaft vorhanden ist, und bestimmt, falls ja, ihren Typ.
GetStringArray	Ruft eine Eigenschaft ab, die ein Array von Zeichenfolgen darstellt.
GetTimeSpan	Ruft eine Eigenschaft ab, die eine WMI-Zeitspanne darstellt.
GetVariant	Ruft eine VARIANT-Eigenschaft ab.
GetWBEMINT16	Ruft eine 16-Bit-ganzzahlige Eigenschaft ab.
GetWBEMINT64	Überladen. Ruft eine ganzzahlige 64-Bit-Eigenschaft ab.
GetWCHAR	Ruft eine WCHAR-Eigenschaft ab.
Getword	Ruft eine WORD-Eigenschaft ab.
IsNull	Bestimmt, ob der Wert einer bestimmten Eigenschaft NULL ist.
Setbool	Legt eine boolesche Eigenschaft fest.
Setbyte	Legt eine BYTE-Eigenschaft fest.
SetCharSplat	Überladen. Legt eine Zeichenfolgeneigenschaft fest.
SetCHString	Überladen. Legt eine Zeichenfolgeneigenschaft fest.
SetDateTime	Legt eine datetime-Eigenschaft fest.
Setdouble	Legt eine DOUBLE-Eigenschaft fest.
SetDWORD	Legt eine DWORD-Eigenschaft fest.
SetEmbeddedObject	Legt eine eingebettete CInstance-Eigenschaft fest.
SetNull	Legt eine Eigenschaft auf NULL fest.
SetStringArray	Legt eine Eigenschaft fest, die ein Array von Zeichenfolgen darstellt.
SetTimeSpan	Legt eine Eigenschaft fest, die eine Zeitspanne darstellt.
SetVariant	Legt eine VARIANT-Eigenschaft fest.
SetWBEMINT16	Legt eine ganzzahlige 16-Bit-Eigenschaft fest.
SetWBEMINT64	Überladen. Legt eine 64-Bit-Ganzzahleigenschaft fest.
SetWCHARSplat	Legt eine WCHAR-Zeichenfolgeneigenschaft fest.
SetWORD	Legt eine WORD-Eigenschaft fest.

Methoden

Die CInstance-Klasse verfügt über diese Methoden.

CInstance::Commit Die Commit-Methode gibt den aktuellen instance an WMI zurück.
CInstance::Getbool Die Getbool-Methode ruft eine boolesche Eigenschaft ab.
CInstance::GetByte Die GetByte-Methode ruft eine BYTE-kompatible Eigenschaft ab.
CInstance::GetCHString Die GetCHString-Methode ruft eine Zeichenfolgeneigenschaft ab.
CInstance::GetClassObjectInterface Die GetClassObjectInterface-Methode gibt einen IWbemClassObject-Schnittstellenzeiger zurück.
CInstance::GetDateTime Die GetDateTime-Methode gibt eine datetime-Eigenschaft zurück.
CInstance::GetDOUBLE Die GetDOUBLE-Methode ruft eine DOUBLE-Eigenschaft ab.
CInstance::GetDWORD Die GetDWORD-Methode ruft eine DWORD-Eigenschaft ab.
CInstance::GetEmbeddedObject Die GetEmbeddedObject-Methode ruft einen Zeiger auf ein eingebettetes CInstance-Objekt ab. Der Zeiger kann verwendet werden, um Eigenschaften dieses eingebetteten Objekts abzurufen und festzulegen.
CInstance::GetMethodContext Die GetMethodContext-Methode gibt einen Zeiger auf ein MethodContext-Objekt zurück.
CInstance::GetStatus Die GetStatus-Methode bestimmt, ob eine Eigenschaft vorhanden ist, und bestimmt, wenn dies deren Typ ist.
CInstance::GetStringArray Die GetStringArray-Methode ruft eine Eigenschaft ab, die ein Array von Zeichenfolgen darstellt.
CInstance::GetTimeSpan Die GetTimeSpan-Methode ruft eine Eigenschaft ab, die eine WMI-Zeitspanne darstellt.
CInstance::GetVariant Die GetVariant-Methode ruft eine VARIANT-Eigenschaft ab.
CInstance::GetWBEMINT16 Die GetWBEMINT16-Methode ruft eine 16-Bit-Ganzzahleigenschaft ab.
CInstance::GetWBEMINT64 Die GetWBEMINT64-Methode ruft eine 64-Bit-Ganzzahleigenschaft ab. (Überladung 1/3)
CInstance::GetWBEMINT64 Die GetWBEMINT64-Methode ruft eine 64-Bit-Ganzzahleigenschaft ab. (Überladung 3/3)
CInstance::GetWBEMINT64 Die GetWBEMINT64-Methode ruft eine 64-Bit-Ganzzahleigenschaft ab. (Überladung 2/3)
CInstance::GetWCHAR Die GetWCHAR-Methode ruft eine WCHAR-Zeichenfolgeneigenschaft ab.
CInstance::GetWORD Die GetWORD-Methode ruft eine WORD-Eigenschaft ab.
CInstance::IsNull Die IsNull-Methode bestimmt, ob der Wert einer bestimmten Eigenschaft NULL ist.
CInstance::Setbool Die Setbool-Methode legt eine boolesche Eigenschaft fest.
CInstance::SetByte Die SetByte-Methode legt eine BYTE-Eigenschaft fest.
CInstance::SetCharSplat Die SetCharSplat(LPCWSTR, DWORD)-Methode legt eine Zeichenfolge fest.
CInstance::SetCharSplat Die SetCharSplat(LPCWSTR, LPCSTR)-Methode legt eine Zeichenfolgeneigenschaft fest.
CInstance::SetCharSplat Die SetCharSplat(LPCWSTR, LPCWSTR)-Methode legt eine Zeichenfolgeneigenschaft fest.
CInstance::SetCHString Die SetCHString(LPCWSTR, const CHString&)-Methode legt eine Zeichenfolgeneigenschaft fest. (Überladung 2/2)
CInstance::SetCHString Die SetCHString(LPCWSTR, LPCSTR)-Methode legt eine Zeichenfolgeneigenschaft fest.
CInstance::SetCHString Die SetCHString(LPCWSTR, const CHString&)-Methode legt eine Zeichenfolgeneigenschaft fest. (Überladung 1/2)
CInstance::SetDateTime Die SetDateTime-Methode legt eine datetime-Eigenschaft fest.
CInstance::SetDOUBLE CInstance::SetDOUBLE-Methode
CInstance::SetDWORD Die SetDWORD-Methode legt eine DWORD-Eigenschaft fest.
CInstance::SetEmbeddedObject Die SetEmbeddedObject-Methode legt eine eingebettete CInstance-Eigenschaft fest.
CInstance::SetNull Die SetNull-Methode legt eine Eigenschaft auf NULL fest.
CInstance::SetStringArray Die SetStringArray-Methode legt eine Eigenschaft fest, die ein Array von Zeichenfolgen darstellt.
CInstance::SetTimeSpan Die SetTimeSpan-Methode legt eine Eigenschaft fest, die eine Zeitspanne darstellt.
CInstance::SetVariant Die SetVariant-Methode legt eine VARIANT-Eigenschaft fest.
CInstance::SetWBEMINT16 Die SetWBEMINT16-Methode legt eine 16-Bit-Ganzzahleigenschaft fest.
CInstance::SetWBEMINT64 Die SetWBEMINT64(LPCWSTR, const LONGLONG&)-Methode legt einen 64-Bit-Ganzzahlwert fest. (Überladung 3/3)
CInstance::SetWBEMINT64 Die SetWBEMINT64(LPCWSTR, const LONGLONG&)-Methode legt einen 64-Bit-Ganzzahlwert fest. (Überladung 1/3)
CInstance::SetWBEMINT64 Die SetWBEMINT64(LPCWSTR, const LONGLONG&)-Methode legt einen 64-Bit-Ganzzahlwert fest. (Überladung 2/3)
CInstance::SetWCHARSplat Die SetWCHARSplat-Methode legt eine Zeichenfolgeneigenschaft fest.
CInstance::SetWORD Die SetWORD-Methode legt eine WORD-Eigenschaft fest.

Hinweise

Der Destruktor für diese Klasse ist CInstance::~CInstance.

Methoden der CInstance-Klasse werden verwendet, um Eigenschaftswerte abzurufen und festzulegen. Eigenschaftendatentypen werden mithilfe von CIM-Datentypen definiert, die in einer MOF-Datei angezeigt werden können. Beim Abfragen oder Festlegen eines Eigenschaftswerts mithilfe von CInstance-Methoden muss eine Methode verwendet werden, die mit dem CIM-Datentyp der Eigenschaft kompatibel ist. In der folgenden Tabelle sind CIM-Datentypen und die zulässigen CInstance-Get - oder -Set-Methoden für den Zugriff auf eine Eigenschaft dieses Datentyps aufgeführt.

CMI-Datentyp	CInstance Get/Set-Methodentypen
string	CHString VARIANT WCHAR CharSplat
sint8	VARIANT
uint8	BYTE
sint16	WBEMINT16 VARIANT
uint16	WORD DWORD VARIANT
sint32	WORD DWORD VARIANT
uint32	WORD DWORD VARIANT
sint64	CHString VARIANT WBEMINT64 WCHAR
uint64	CHString VARIANT WBEMINT64 WCHAR
real32	VARIANT
real64	CHString Double VARIANT
char16	VARIANT
DateTime	CHString Datetime VARIANT WCHAR

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	instance.h (schließen Sie FwCommon.h ein)