Método IWbemPathKeyList::GetKey (wmiutils.h)
El método IWbemPathKeyList::GetKey recupera el nombre o el valor de una clave. Las claves se indexan a partir de 0 (cero), aunque el orden de las claves no es significativo.
Sintaxis
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 clave a partir de 0 (cero).
[in] uFlags
Reservado. Debe ser 0 (cero).
[in, out] puNameBufSize
El autor de la llamada establece este valor en el número de caracteres que puede contener el búfer de nombres. Si se ejecuta correctamente, se establece en el número de caracteres copiados en el búfer, incluido el valor NULL de terminación.
[in, out] pszKeyName
Búfer en el que se va a copiar el nombre. Dado que no todas las claves tienen un nombre, este valor de parámetro sería NULL para una clave implícita.
[in, out] puKeyValBufSize
El autor de la llamada establece este valor en el número de caracteres que puede contener el búfer de valores. Si se ejecuta correctamente, se establece en el número de caracteres copiados en el búfer, incluido el terminador NULL .
[in, out] pKeyVal
Búfer donde se van a copiar los datos.
[in, out] puApparentCimType
Puntero a un long 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
Se recomienda determinar el tamaño de un búfer llamando a este método, pasando un puntero NULL para el búfer y estableciendo su parámetro de tamaño en 0 (cero). Tras la devolución, el parámetro size del búfer indica el tamaño necesario de un búfer para la cadena y su terminador NULL . A continuación, puede llamar al método para obtener el valor del búfer.
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 |