Classe CInstance (instance.h)

[A classe CInstance faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]

A classe CInstance é usada para recuperar e atualizar os valores das propriedades definidas para as instâncias compatíveis com o WMI Provider Framework. A classe CInstance também fornece acesso à implementação da estrutura do provedor da interface CInstance .

Não se espera que os gravadores de provedores precisem derivar dessa classe. Use Provider::CreateNewInstance para criar uma instância dessa classe.

O CInstance tem estes tipos de membros:

Método	Descrição
Confirmar	Retorna a instância atual para WMI.
Getbool	Recupera uma propriedade booliana.
Getbyte	Recupera uma propriedade compatível com BYTE.
GetCHString	Recupera uma propriedade de cadeia de caracteres.
GetClassObjectInterface	Retorna um ponteiro de interface IWbemClassObject .
Getdatetime	Retorna uma propriedade datetime.
Getdouble	Recupera uma propriedade DOUBLE .
GetDWORD	Recupera uma propriedade DWORD .
GetEmbeddedObject	Recupera uma propriedade CInstance inserida .
GetMethodContext	Retorna um ponteiro para um objeto MethodContext .
GetStatus	Determina se existe uma propriedade e, em caso afirmativo, determina seu tipo.
GetStringArray	Recupera uma propriedade que representa uma matriz de cadeias de caracteres.
GetTimeSpan	Recupera uma propriedade que representa um intervalo de tempo WMI.
GetVariant	Recupera uma propriedade VARIANT .
GetWBEMINT16	Recupera uma propriedade de inteiro de 16 bits.
GetWBEMINT64	Sobrecarregado. Recupera uma propriedade de inteiro de 64 bits.
GetWCHAR	Recupera uma propriedade WCHAR .
GetWORD	Recupera uma propriedade WORD .
IsNull	Determina se o valor de uma propriedade específica é NULL.
Setbool	Define uma propriedade booliana .
Setbyte	Define uma propriedade BYTE .
SetCharSplat	Sobrecarregado. Define uma propriedade de cadeia de caracteres.
SetCHString	Sobrecarregado. Define uma propriedade de cadeia de caracteres.
SetDateTime	Define uma propriedade datetime.
Setdouble	Define uma propriedade DOUBLE .
SetDWORD	Define uma propriedade DWORD .
SetEmbeddedObject	Define uma propriedade CInstance inserida .
SetNull	Define uma propriedade como NULL.
SetStringArray	Define uma propriedade que representa uma matriz de cadeias de caracteres.
SetTimeSpan	Define uma propriedade que representa um intervalo de tempo.
SetVariant	Define uma propriedade VARIANT .
SetWBEMINT16	Define uma propriedade de inteiro de 16 bits.
SetWBEMINT64	Sobrecarregado. Define uma propriedade de inteiro de 64 bits.
SetWCHARSplat	Define uma propriedade de cadeia de caracteres WCHAR .
SetWORD	Define uma propriedade WORD .

Métodos

A classe CInstance tem esses métodos.

CInstance::Commit O método Commit retorna a instância atual para WMI.
CInstance::Getbool O método Getbool recupera uma propriedade booliana.
CInstance::GetByte O método GetByte recupera uma propriedade compatível com BYTE.
CInstance::GetCHString O método GetCHString recupera uma propriedade de cadeia de caracteres.
CInstance::GetClassObjectInterface O método GetClassObjectInterface retorna um ponteiro de interface IWbemClassObject.
CInstance::GetDateTime O método GetDateTime retorna uma propriedade datetime.
CInstance::GetDOUBLE O método GetDOUBLE recupera uma propriedade DOUBLE.
CInstance::GetDWORD O método GetDWORD recupera uma propriedade DWORD.
CInstance::GetEmbeddedObject O método GetEmbeddedObject recupera um ponteiro para um objeto CInstance inserido. O ponteiro pode ser usado para obter e definir propriedades desse objeto inserido.
CInstance::GetMethodContext O método GetMethodContext retorna um ponteiro para um objeto MethodContext.
CInstance::GetStatus O método GetStatus determina se uma propriedade existe e, em caso afirmativo, determina seu tipo.
CInstance::GetStringArray O método GetStringArray recupera uma propriedade que representa uma matriz de cadeias de caracteres.
CInstance::GetTimeSpan O método GetTimeSpan recupera uma propriedade que representa um período de tempo WMI.
CInstance::GetVariant O método GetVariant recupera uma propriedade VARIANT.
CInstance::GetWBEMINT16 O método GetWBEMINT16 recupera uma propriedade de inteiro de 16 bits.
CInstance::GetWBEMINT64 O método GetWBEMINT64 recupera uma propriedade de inteiro de 64 bits. (sobrecarga 1/3)
CInstance::GetWBEMINT64 O método GetWBEMINT64 recupera uma propriedade de inteiro de 64 bits. (sobrecarga 3/3)
CInstance::GetWBEMINT64 O método GetWBEMINT64 recupera uma propriedade de inteiro de 64 bits. (sobrecarga 2/3)
CInstance::GetWCHAR O método GetWCHAR recupera uma propriedade de cadeia de caracteres WCHAR.
CInstance::GetWORD O método GetWORD recupera uma propriedade WORD.
CInstance::IsNull O método IsNull determina se o valor de uma propriedade específica é NULL.
CInstance::Setbool O método Setbool define uma propriedade booliana.
CInstance::SetByte O método SetByte define uma propriedade BYTE.
CInstance::SetCharSplat O método SetCharSplat(LPCWSTR, DWORD) define uma cadeia de caracteres.
CInstance::SetCharSplat O método SetCharSplat(LPCWSTR, LPCSTR) define uma propriedade de cadeia de caracteres.
CInstance::SetCharSplat O método SetCharSplat(LPCWSTR, LPCWSTR) define uma propriedade de cadeia de caracteres.
CInstance::SetCHString O método SetCHString(LPCWSTR, const CHString&) define uma propriedade de cadeia de caracteres. (sobrecarga 2/2)
CInstance::SetCHString O método SetCHString(LPCWSTR, LPCSTR) define uma propriedade de cadeia de caracteres.
CInstance::SetCHString O método SetCHString(LPCWSTR, const CHString&) define uma propriedade de cadeia de caracteres. (sobrecarga 1/2)
CInstance::SetDateTime O método SetDateTime define uma propriedade datetime.
CInstance::SetDOUBLE Método CInstance::SetDOUBLE
CInstance::SetDWORD O método SetDWORD define uma propriedade DWORD.
CInstance::SetEmbeddedObject O método SetEmbeddedObject define uma propriedade CInstance inserida.
CInstance::SetNull O método SetNull define uma propriedade como NULL.
CInstance::SetStringArray O método SetStringArray define uma propriedade que representa uma matriz de cadeias de caracteres.
CInstance::SetTimeSpan O método SetTimeSpan define uma propriedade que representa um período de tempo.
CInstance::SetVariant O método SetVariant define uma propriedade VARIANT.
CInstance::SetWBEMINT16 O método SetWBEMINT16 define uma propriedade de inteiro de 16 bits.
CInstance::SetWBEMINT64 O método SetWBEMINT64(LPCWSTR, const LONGLONG&) define um valor inteiro de 64 bits. (sobrecarga 3/3)
CInstance::SetWBEMINT64 O método SetWBEMINT64(LPCWSTR, const LONGLONG&) define um valor inteiro de 64 bits. (sobrecarga 1/3)
CInstance::SetWBEMINT64 O método SetWBEMINT64(LPCWSTR, const LONGLONG&) define um valor inteiro de 64 bits. (sobrecarga 2/3)
CInstance::SetWCHARSplat O método SetWCHARSplat define uma propriedade de cadeia de caracteres.
CInstance::SetWORD O método SetWORD define uma propriedade WORD.

Comentários

O destruidor dessa classe é CInstance::~CInstance.

Os métodos da classe CInstance são usados para recuperar e definir valores de propriedade. Os tipos de dados de propriedade são definidos usando tipos de dados CIM que podem ser vistos em um arquivo .mof. Ao consultar ou definir um valor de propriedade usando métodos CInstance , é necessário usar um método compatível com o tipo de dados CIM da propriedade. A tabela a seguir lista os tipos de dados CIM e os métodos permissíveis de obtenção ou definição de CInstance para acessar uma propriedade desse tipo de dados.

Tipo de dados CIM	Tipos de método Get/Set do CInstance
cadeia de caracteres	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

Requisitos

Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	instance.h (inclua FwCommon.h)