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

La méthode IWbemPathKeyList ::GetKey2 récupère un nom de clé ou une valeur et retourne la valeur sous la forme d’un VARIANT. Une clé est indexée à partir de 0 (zéro), mais l’ordre de clé n’est pas significatif.

Syntaxe

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

Paramètres

[in] uKeyIx

L’index de clé commence à 0 (zéro).

[in] uFlags

Réservé. Doit être égal à 0 (zéro).

[in, out] puNameBufSize

L’appelant définit ce paramètre sur le nombre de caractères que la mémoire tampon de noms peut contenir. En cas de réussite, cette valeur est définie sur le nombre de caractères copiés dans la mémoire tampon, y compris la valeur NULL de fin.

[out] pszKeyName

Mémoire tampon dans laquelle le nom est copié. Étant donné que toutes les clés n’ont pas de nom, cette valeur de paramètre est NULL pour une clé implicite.

[out] pKeyValue

Pointeur vers une variante qui contient la valeur de clé.

[out] puApparentCimType

Pointeur vers un entier long défini sur le type CIM.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique l’état de l’appel de méthode.

Remarques

Cette méthode peut être utilisée pour déterminer la taille d’une mémoire tampon en passant un pointeur NULL pour la mémoire tampon et en définissant son paramètre de taille sur 0 (zéro). Lorsqu’il est retourné, le paramètre de taille de la mémoire tampon indique la mémoire tampon de taille nécessaire pour la chaîne et sa marque de fin NULL .

Configuration requise

Voir aussi

IWbemPath

Méthode IWbemPathKeyList

IWbemPathKeyList ::GetKey