Método IWbemCallResult::GetResultString (wbemcli.h)

Artigo
03/03/2024

O método IWbemCallResult::GetResultString retorna o caminho do objeto atribuído de uma instância recém-criada por IWbemServices::P utInstance.

Nota O objeto de resultado da chamada é usado principalmente quando a chamada PutInstance é executada por um provedor e o cliente precisa saber o caminho do objeto (os valores das propriedades de chave) atribuídos ao provedor. Por exemplo, se a propriedade de chave de classe for um GUID (identificador global exclusivo), atribuído pelo provedor durante a operação PutInstance , o cliente não teria como conhecer esse GUID, a menos que o provedor pudesse devolvê-lo dessa maneira.

Sintaxe

HRESULT GetResultString(
  [in]  long lTimeout,
  [out] BSTR *pstrResultString
);

Parâmetros

[in] lTimeout

Especifica o tempo máximo em milissegundos que essa chamada bloqueia antes de retornar. Se você usar a constante WBEM_INFINITE (0xFFFFFFFF), a chamada será bloqueada até que o caminho do objeto esteja disponível. Se você usar 0, a chamada retornará imediatamente o caminho do objeto ou um código status.

[out] pstrResultString

Não pode ser NULL. Esse parâmetro recebe um ponteiro para o caminho do objeto, que, por sua vez, leva ao objeto recém-criado. A cadeia de caracteres retornada deve ser desalocada usando a chamada do sistema SysFreeString. Em caso de erro, uma nova cadeia de caracteres não é retornada.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.

Em caso de erro, você pode chamar a função COM GetErrorInfo para obter mais informações de erro.

Códigos de erro específicos de COM também poderão ser retornados se problemas de rede fizerem com que você perca a conexão remota com o Gerenciamento do Windows.

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)

Confira também

IWbemCallResult

IWbemServices::PutInstance

Compartilhar via