Méthode IWbemPath ::GetNamespaceAt (wmiutils.h)

La méthode IWbemPath ::GetNamespaceAt récupère un espace de noms en fonction de son index. L’espace de noms le plus à gauche du chemin d’accès a un index 0, chaque espace de noms se déplaçant vers la droite ayant une valeur d’index progressivement plus élevée.

Syntaxe

HRESULT GetNamespaceAt(
  [in]      ULONG  uIndex,
  [in, out] ULONG  *puNameBufLength,
  [in, out] LPWSTR pName
);

Paramètres

[in] uIndex

Index de l’espace de noms à lire. L’espace de noms le plus à gauche dans le chemin d’accès est l’index 0, chaque espace de noms à droite ayant une valeur d’index progressivement plus élevée. La valeur maximale autorisée est inférieure au nombre actuel d’espaces de noms.

[in, out] puNameBufLength

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

[in, out] pName

Nom de l’espace de noms.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode.

Remarques

Cette méthode peut être utilisée pour déterminer la taille d’une mémoire tampon nécessaire pour pName. Pour ce faire, transmettez un pointeur NULL pour la mémoire tampon, définissez puNameBufLength sur 0, puis effectuez l’appel. Au retour, puNameBufLength indique la taille d’une mémoire tampon nécessaire pour pName et son caractère NULL de fin.

Configuration requise

Voir aussi

IWbemPath