Freigeben über


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)