Класс CInstance (instance.h)

[Класс CInstance является частью платформы поставщика WMI, которая теперь рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Класс CInstance используется для получения и обновления значений свойств, определенных для экземпляров, поддерживаемых платформой поставщика WMI. Класс CInstance также предоставляет доступ к реализации интерфейса CInstance платформы поставщика.

Не ожидается, что записи поставщика должны быть производными от этого класса. Используйте Provider::CreateNewInstance , чтобы создать экземпляр этого класса.

CInstance имеет следующие типы членов:

Метод	Описание
Фиксация	Возвращает текущий экземпляр в WMI.
Getbool	Извлекает логическое свойство.
GetByte	Извлекает свойство, совместимое с BYTE.
GetCHString	Извлекает строковое свойство.
GetClassObjectInterface	Возвращает указатель интерфейса IWbemClassObject .
GetDateTime	Возвращает свойство datetime.
GetDOUBLE	Извлекает свойство DOUBLE .
GetDWORD	Извлекает свойство DWORD .
GetEmbeddedObject	Извлекает внедренное свойство CInstance .
GetMethodContext	Возвращает указатель на объект MethodContext .
GetStatus	Определяет, существует ли свойство, и, если да, определяет его тип.
GetStringArray	Извлекает свойство, представляющее массив строк.
GetTimeSpan	Извлекает свойство, представляющее диапазон времени WMI.
GetVariant	Извлекает свойство VARIANT .
GetWBEMINT16	Извлекает 16-разрядное целочисленное свойство.
GetWBEMINT64	Перегружен. Извлекает 64-разрядное целочисленное свойство.
GetWCHAR	Извлекает свойство WCHAR .
GetWORD	Извлекает свойство WORD .
IsNull	Определяет, равно ли значение определенного свойства NULL.
Setbool	Задает логическое свойство.
SetByte	Задает свойство BYTE .
SetCharSplat	Перегружен. Задает строковое свойство.
SetCHString	Перегружен. Задает строковое свойство.
SetDateTime	Задает свойство datetime.
SetDOUBLE	Задает свойство DOUBLE .
SetDWORD	Задает свойство DWORD .
SetEmbeddedObject	Задает внедренное свойство CInstance .
SetNull	Задает для свойства значение NULL.
SetStringArray	Задает свойство , представляющее массив строк.
SetTimeSpan	Задает свойство, представляющее период времени.
SetVariant	Задает свойство VARIANT .
SetWBEMINT16	Задает 16-разрядное целочисленное свойство.
SetWBEMINT64	Перегружен. Задает 64-разрядное целочисленное свойство.
SetWCHARSplat	Задает строковое свойство WCHAR .
SetWORD	Задает свойство WORD .

Методы

Класс CInstance содержит следующие методы.

CInstance::Commit Метод Commit возвращает текущий экземпляр в WMI.
CInstance::Getbool Метод Getbool извлекает логическое свойство.
CInstance::GetByte Метод GetByte извлекает свойство, совместимое с BYTE.
CInstance::GetCHString Метод GetCHString извлекает строковое свойство.
CInstance::GetClassObjectInterface Метод GetClassObjectInterface возвращает указатель интерфейса IWbemClassObject.
CInstance::GetDateTime Метод GetDateTime возвращает свойство datetime.
CInstance::GetDOUBLE Метод GetDOUBLE извлекает свойство DOUBLE.
CInstance::GetDWORD Метод GetDWORD извлекает свойство DWORD.
CInstance::GetEmbeddedObject Метод GetEmbeddedObject извлекает указатель на внедренный объект CInstance. Указатель можно использовать для получения и задания свойств этого внедренного объекта.
CInstance::GetMethodContext Метод GetMethodContext возвращает указатель на объект MethodContext.
CInstance::GetStatus Метод GetStatus определяет, существует ли свойство, и, если да, определяет его тип.
CInstance::GetStringArray Метод GetStringArray извлекает свойство, представляющее массив строк.
CInstance::GetTimeSpan Метод GetTimeSpan извлекает свойство, представляющее диапазон времени WMI.
CInstance::GetVariant Метод GetVariant извлекает свойство VARIANT.
CInstance::GetWBEMINT16 Метод GetWBEMINT16 извлекает 16-разрядное целочисленное свойство.
CInstance::GetWBEMINT64 Метод GetWBEMINT64 извлекает 64-разрядное целочисленное свойство. (перегрузка 1/3)
CInstance::GetWBEMINT64 Метод GetWBEMINT64 извлекает 64-разрядное целочисленное свойство. (перегрузка 3/3)
CInstance::GetWBEMINT64 Метод GetWBEMINT64 извлекает 64-разрядное целочисленное свойство. (перегрузка 2/3)
CInstance::GetWCHAR Метод GetWCHAR извлекает строковое свойство WCHAR.
CInstance::GetWORD Метод GetWORD извлекает свойство WORD.
CInstance::IsNull Метод IsNull определяет, равно ли значение определенного свойства NULL.
CInstance::Setbool Метод Setbool задает логическое свойство.
CInstance::SetByte Метод SetByte задает свойство BYTE.
CInstance::SetCharsplat Метод SetCharSplat(LPCWSTR, DWORD) задает строку.
CInstance::SetCharsplat Метод SetCharSplat(LPCWSTR, LPCSTR) задает строковое свойство.
CInstance::SetCharsplat Метод SetCharSplat(LPCWSTR, LPCWSTR) задает строковое свойство.
CInstance::SetCHString Метод SetCHString(LPCWSTR, const CHString&) задает строковое свойство. (перегрузка 2/2)
CInstance::SetCHString Метод SetCHString(LPCWSTR, LPCSTR) задает строковое свойство.
CInstance::SetCHString Метод SetCHString(LPCWSTR, const CHString&) задает строковое свойство. (перегрузка 1/2)
CInstance::SetDateTime Метод SetDateTime задает свойство datetime.
CInstance::SetDOUBLE Метод CInstance::SetDOUBLE
CInstance::SetDWORD Метод SetDWORD задает свойство DWORD.
CInstance::SetEmbeddedObject Метод SetEmbeddedObject задает внедренное свойство CInstance.
CInstance::SetNull Метод SetNull задает для свойства значение NULL.
CInstance::SetStringArray Метод SetStringArray задает свойство, представляющее массив строк.
CInstance::SetTimeSpan Метод SetTimeSpan задает свойство, представляющее период времени.
CInstance::SetVariant Метод SetVariant задает свойство VARIANT.
CInstance::SetWBEMINT16 Метод SetWBEMINT16 задает 16-разрядное целочисленное свойство.
CInstance::SetWBEMINT64 Метод SetWBEMINT64(LPCWSTR, const LONGLONG&) задает 64-разрядное целое значение. (перегрузка 3/3)
CInstance::SetWBEMINT64 Метод SetWBEMINT64(LPCWSTR, const LONGLONG&) задает 64-разрядное целое значение. (перегрузка 1/3)
CInstance::SetWBEMINT64 Метод SetWBEMINT64(LPCWSTR, const LONGLONG&) задает 64-разрядное целое значение. (перегрузка 2/3)
CInstance::SetWCHARSplat Метод SetWCHARSplat задает строковое свойство.
CInstance::SetWORD Метод SetWORD задает свойство WORD.

Комментарии

Деструктором для этого класса является CInstance::~CInstance.

Методы класса CInstance используются для получения и задания значений свойств. Типы данных свойств определяются с помощью типов данных CIM, которые можно увидеть в MOF-файле. При запросе или задании значения свойства с помощью методов CInstance необходимо использовать метод, совместимый с типом данных CIM свойства. В следующей таблице перечислены типы данных CIM и допустимые методы получения или задания CInstance для доступа к свойству этого типа данных.

Тип данных CIM	Типы методов CInstance Get/Set
строка	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 Дата и время VARIANT WCHAR

Требования

Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	instance.h (включая FwCommon.h)