Metodo IWbemPathKeyList::GetKey (wmiutils.h)

Il metodo IWbemPathKeyList::GetKey recupera il nome o il valore di una chiave. Le chiavi vengono indicizzate da 0 (zero), anche se l'ordine delle chiavi non è significativo.

Sintassi

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
);

Parametri

[in] uKeyIx

Indice chiave a partire da 0 (zero).

[in] uFlags

Riservato. Deve essere 0 (zero).

[in, out] puNameBufSize

Il chiamante imposta questo valore sul numero di caratteri che il buffer dei nomi può contenere. Al termine, questo valore viene impostato sul numero di caratteri copiati nel buffer, incluso il valore NULL terminante.

[in, out] pszKeyName

Buffer in cui copiare il nome. Poiché non tutte le chiavi hanno un nome, questo valore di parametro sarà NULL per una chiave implicita.

[in, out] puKeyValBufSize

Il chiamante imposta questo valore sul numero di caratteri che il buffer dei valori può contenere. Al termine, questo valore viene impostato sul numero di caratteri copiati nel buffer, incluso il terminatore NULL .

[in, out] pKeyVal

Buffer in cui copiare i dati.

[in, out] puApparentCimType

Puntatore a un valore lungo impostato sul tipo CIM.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo.

Commenti

È una procedura consigliata per determinare la dimensione necessaria di un buffer chiamando questo metodo, passando un puntatore NULL per il buffer e impostando il parametro di dimensioni su 0 (zero). Al ritorno, il parametro dimensioni del buffer indica la quantità di un buffer necessaria per la stringa e il relativo terminatore NULL . È quindi possibile chiamare il metodo per ottenere il valore del buffer.

Requisiti

Vedi anche

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey2