Método IWbemPathKeyList::GetKey2 (wmiutils.h)

El método IWbemPathKeyList::GetKey2 recupera un nombre o valor de clave y devuelve el valor como VARIANT. Una clave se indexa a partir de 0 (cero), pero el orden de la clave no es significativo.

Sintaxis

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

El índice de clave comienza en 0 (cero).

[in] uFlags

Reservado. Debe ser 0 (cero).

[in, out] puNameBufSize

El autor de la llamada establece este parámetro en el número de caracteres que puede contener el búfer de nombres. Cuando se ejecuta correctamente, se establece en el número de caracteres que se copian en el búfer, incluido el valor NULL de terminación.

[out] pszKeyName

Búfer en el que se copia el nombre. Dado que no todas las claves tienen un nombre, este valor de parámetro es NULL para una clave implícita.

[out] pKeyValue

Puntero a una variante que contiene el valor de clave.

[out] puApparentCimType

Puntero a un entero largo que se establece en el tipo CIM.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método.

Comentarios

Este método se puede usar para determinar el tamaño que necesita un búfer pasando un puntero NULL para el búfer y estableciendo su parámetro de tamaño en 0 (cero). Cuando se devuelve, el parámetro de tamaño del búfer indica el búfer de tamaño necesario para la cadena y su terminador NULL .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wmiutils.h
Library	Wbemuuid.lib
Archivo DLL	Wmiutils.dll

Consulte también

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey