Método IWbemObjectAccess::ReadPropertyValue (wbemcli.h)

O método ReadPropertyValue retorna um número especificado de bytes de uma propriedade associada a um identificador de propriedade. Use esse método para ler o valor de uma propriedade que contém uma cadeia de caracteres ou para ler uma propriedade que contém um valor que não tem 32 bits (DWORD) ou 64 (QWORD).

Sintaxe

HRESULT ReadPropertyValue(
  [in]  long lHandle,
  [in]  long lBufferSize,
  [out] long *plNumBytes,
  [out] byte *aData
);

Parâmetros

[in] lHandle

Inteiro que contém o identificador que identifica essa propriedade.

[in] lBufferSize

Inteiro que contém o tamanho do buffer.

[out] plNumBytes

Ponteiro para um inteiro usado para retornar o número de bytes lidos.

[out] aData

Ponteiro para uma matriz usada para retornar os dados da propriedade.

Retornar valor

Esse método retorna WBEM_S_NO_ERROR se tiver êxito; caso contrário, esse método retorna um HRESULT com um dos valores a seguir.

Comentários

Os dados de cadeia de caracteres são retornados como dados WCHAR encerrados em nulo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (inclua Wbemidl.h)
Biblioteca	Wbemuuid.lib
DLL	Esscli.dll; Fastprox.dll; Wbemess.dll

Confira também

IWbemObjectAccess