Método IWbemPathKeyList::GetKey2 (wmiutils.h)
O método IWbemPathKeyList::GetKey2 recupera um nome ou valor de chave e retorna o valor como variant. Uma chave é indexada de 0 (zero), mas a ordem da chave não é significativa.
Sintaxe
HRESULT GetKey2(
[in] ULONG uKeyIx,
[in] ULONG uFlags,
[in, out] ULONG *puNameBufSize,
[out] LPWSTR pszKeyName,
[out] VARIANT *pKeyValue,
[out] ULONG *puApparentCimType
);
Parâmetros
[in] uKeyIx
O índice de chave começa em 0 (zero).
[in] uFlags
Reservado. Deve ser 0 (zero).
[in, out] puNameBufSize
O chamador define esse parâmetro como o número de caracteres que o buffer de nomes pode conter. Quando bem-sucedido, isso é definido como o número de caracteres que são copiados para o buffer, incluindo o NULL de terminação.
[out] pszKeyName
Buffer no qual o nome é copiado. Como nem todas as chaves têm um nome, esse valor de parâmetro é NULL para uma chave implícita.
[out] pKeyValue
Ponteiro para uma variante que contém o valor da chave.
[out] puApparentCimType
Ponteiro para um inteiro longo definido como o tipo CIM.
Retornar valor
Esse método retorna um HRESULT que indica o status da chamada de método.
Comentários
Esse método pode ser usado para determinar o tamanho de um buffer necessário passando um ponteiro NULL para o buffer e definindo seu parâmetro de tamanho como 0 (zero). Quando retornado, o parâmetro de tamanho do buffer indica o buffer de tamanho necessário para a cadeia de caracteres e seu terminador NULL .
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 |