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 |