Metodo IWbemPathKeyList::GetKey2 (wmiutils.h)

Il metodo IWbemPathKeyList::GetKey2 recupera un nome o un valore della chiave e restituisce il valore come VARIANT. Una chiave viene indicizzata da 0 (zero), ma l'ordine delle chiavi non è significativo.

Sintassi

HRESULT GetKey2(
  [in]      ULONG   uKeyIx,
  [in]      ULONG   uFlags,
  [in, out] ULONG   *puNameBufSize,
  [out]     LPWSTR  pszKeyName,
  [out]     VARIANT *pKeyValue,
  [out]     ULONG   *puApparentCimType
);

Parametri

[in] uKeyIx

L'indice chiave inizia da 0 (zero).

[in] uFlags

Riservato. Deve essere 0 (zero).

[in, out] puNameBufSize

Il chiamante imposta questo parametro sul numero di caratteri che il buffer dei nomi può contenere. In caso di esito positivo, questo valore viene impostato sul numero di caratteri copiati nel buffer, incluso il valore NULL di terminazione.

[out] pszKeyName

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

[out] pKeyValue

Puntatore a una variante contenente il valore della chiave.

[out] puApparentCimType

Puntatore a un numero intero lungo impostato sul tipo CIM.

Valore restituito

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

Commenti

Questo metodo può essere usato per determinare la dimensione necessaria di un buffer passando un puntatore NULL per il buffer e impostando il relativo parametro size su 0 (zero). Quando viene restituito, il parametro dimensione buffer indica il buffer di dimensioni necessario per la stringa e il relativo carattere di terminazione NULL .

Requisiti

Vedi anche

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey