CInstance-Klasse (instance.h)
[Die CInstance-Klasse ist Teil des WMI-Anbieterframeworks, das jetzt im endgültigen Zustand betrachtet wird, und es stehen keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme zur Verfügung, die sich auf diese Bibliotheken auswirken. Die MI-APIs sollten für alle neuen Entwicklungen verwendet werden.]
Die CInstance-Klasse wird verwendet, um die Werte von 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 des Anbieterframeworks.
Es wird nicht erwartet, dass Anbieterautoren von dieser Klasse abgeleitet werden müssen. Verwenden Sie "Provider::CreateNewInstance" , um eine Instanz dieser Klasse zu erstellen.
CInstance verfügt über diese Arten von Mitgliedern:
| Methode | BESCHREIBUNG |
|---|---|
| Commit | Gibt die aktuelle Instanz 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 falls ja, den Typ bestimmt. |
| 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-Ganzzahleigenschaft ab. |
| GetWBEMINT64 | Überladen. Ruft eine 64-Bit-Ganzzahleigenschaft 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 einen Zeitraum darstellt. |
| SetVariant | Legt eine VARIANT-Eigenschaft fest. |
| SetWBEMINT16 | Legt eine 16-Bit-Ganzzahleigenschaft 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 weist diese Methoden auf.
| CInstance::Commit Die Commit-Methode gibt die aktuelle Instanz 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 falls ja, den Typ bestimmt. |
| 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 einen WMI-Zeitbereich darstellt. |
| CInstance::GetVariant Die GetVariant-Methode ruft eine VARIANT-Eigenschaft ab. |
| CInstance::GetWBEMINT16 Die GetWBEMINT16-Methode ruft eine 16-Bit-ganzzahlige Eigenschaft ab. |
| CInstance::GetWBEMINT64 Die GetWBEMINT64-Methode ruft eine 64-Bit-ganzzahlige Eigenschaft ab. (Überladung 1/3) |
| CInstance::GetWBEMINT64 Die GetWBEMINT64-Methode ruft eine 64-Bit-ganzzahlige Eigenschaft ab. (Überladung 3/3) |
| CInstance::GetWBEMINT64 Die GetWBEMINT64-Methode ruft eine 64-Bit-ganzzahlige Eigenschaft 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 Boolean-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 einen Zeitraum darstellt. |
| CInstance::SetVariant Die SetVariant-Methode legt eine VARIANT-Eigenschaft fest. |
| CInstance::SetWBEMINT16 Die SetWBEMINT16-Methode legt eine 16-Bit-ganzzahlige Eigenschaft 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 Eigenschaftenwerte 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 ist es notwendig, eine Methode zu verwenden, die mit dem CIM-Datentyp der Eigenschaft kompatibel ist. In der folgenden Tabelle sind CIM-Datentypen und die zulässigen CInstance-Methoden für den Zugriff auf eine Eigenschaft dieses Datentyps aufgeführt.
| CMI-Datentyp | CInstance Get/Set-Methodentypen |
|---|---|
| string |
VARIANT WCHAR CharSplat |
| sint8 | VARIANT |
| uint8 | BYTE |
| sint16 |
WBEMINT16 VARIANT |
| uint16 |
WORD DWORD VARIANT |
| sint32 |
WORD DWORD VARIANT |
| uint32 |
WORD DWORD VARIANT |
| sint64 |
VARIANT WBEMINT64 WCHAR |
| uint64 |
VARIANT WBEMINT64 WCHAR |
| real32 | VARIANT |
| real64 |
Double VARIANT |
| char16 | VARIANT |
| DateTime |
Datetime VARIANT WCHAR |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | instance.h (enthalten FwCommon.h) |