Класс 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 |
|---|---|
| строка |
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 |
Дата и время VARIANT WCHAR |
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | instance.h (включая FwCommon.h) |