Método IWbemPropertyProvider::GetProperty (wbemprov.h)

Artigo
03/03/2024

O método IWbemPropertyProvider::GetProperty é chamado pelo Gerenciamento do Windows para recuperar um valor de propriedade individual.

Sintaxe

HRESULT GetProperty(
  [in]  long       lFlags,
  [in]  const BSTR strLocale,
  [in]  const BSTR strClassMapping,
  [in]  const BSTR strInstMapping,
  [in]  const BSTR strPropMapping,
  [out] VARIANT    *pvValue
);

Parâmetros

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[in] strLocale

Cadeia de caracteres que indica a localidade desejada nos casos em que o valor da propriedade retornada pode ser localizado. Se a propriedade não puder ser localizada, a implementação poderá ignorar esse valor.

[in] strClassMapping

Cópia literal do valor da cadeia de caracteres para o qualificador ClassContext para a classe . Isso aponta para um BSTR válido, que é tratado como somente leitura ou NULL se o qualificador não existir.

[in] strInstMapping

Cópia literal do valor da cadeia de caracteres para o qualificador InstanceContext para a instância. Isso deve apontar para um BSTR válido, que é tratado como somente leitura ou NULL se o qualificador não existir.

[in] strPropMapping

Cópia literal do valor do qualificador PropertyContext para a propriedade . Isso deve apontar para um BSTR válido, que é tratado como somente leitura ou NULL se o qualificador não existir.

[out] pvValue

Ponteiro para uma VARIANT não inicializada que recebe o valor da propriedade. A implementação deve chamar VariantInit e retornar o valor. Se ocorrer um erro, espera-se que a implementação ignore o ponteiro.

Retornar valor

Esse método deverá retornar WBEM_S_NO_ERROR se a chamada for bem-sucedida. Se a chamada falhar, o método deverá retornar WBEM_S_FALSE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemprov.h (include Wbemidl.h)
Biblioteca	Wbemuuid.lib
DLL	Wbemsvc.dll

Confira também

Construindo provedores de propriedades

IWbemPropertyProvider

PutProperty

Compartilhar via