Método IWbemPathKeyList::GetKey (wmiutils.h)
O método IWbemPathKeyList::GetKey recupera o nome ou o valor de uma chave. As chaves são indexadas a partir de 0 (zero), embora a ordem das chaves não seja significativa.
Sintaxe
HRESULT GetKey(
[in] ULONG uKeyIx,
[in] ULONG uFlags,
[in, out] ULONG *puNameBufSize,
[in, out] LPWSTR pszKeyName,
[in, out] ULONG *puKeyValBufSize,
[in, out] LPVOID pKeyVal,
[in, out] ULONG *puApparentCimType
);
Parâmetros
[in] uKeyIx
Índice de chave começando em 0 (zero).
[in] uFlags
Reservado. Deve ser 0 (zero).
[in, out] puNameBufSize
O chamador define isso como o número de caracteres que o buffer de nome pode conter. Após o sucesso, isso é definido como o número de caracteres copiados para o buffer, incluindo o NULL de terminação.
[in, out] pszKeyName
Buffer no qual o nome deve ser copiado. Como nem todas as chaves têm um nome, esse valor de parâmetro seria NULL para uma chave implícita.
[in, out] puKeyValBufSize
O chamador define isso como o número de caracteres que o buffer de valor pode conter. Após o sucesso, isso é definido como o número de caracteres copiados para o buffer, incluindo o terminador NULL .
[in, out] pKeyVal
Buffer em que os dados devem ser copiados.
[in, out] puApparentCimType
Ponteiro para um longo que é definido como o tipo CIM.
Retornar valor
Esse método retorna um HRESULT que indica o status da chamada de método.
Comentários
É uma prática recomendada determinar o tamanho que um buffer é necessário chamando esse método, passando um ponteiro NULL para o buffer e definindo seu parâmetro de tamanho como 0 (zero). Após o retorno, o parâmetro de tamanho do buffer indica o tamanho de um buffer necessário para a cadeia de caracteres e seu terminador NULL . Em seguida, você pode chamar o método para obter o valor do buffer.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wmiutils.h |
| Biblioteca | Wbemuuid.lib |
| DLL | Wmiutils.dll |