Compartir a través de


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

Consulte también

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey2