IWbemPath ::GetScopeAsText, méthode (wmiutils.h)

La méthode IWbemPath ::GetScopeAsText récupère une étendue au format texte en fonction d’un index.

Syntaxe

HRESULT GetScopeAsText(
  [in]      ULONG  uIndex,
  [in, out] ULONG  *puTextBufSize,
  [out]     LPWSTR pszText
);

Paramètres

[in] uIndex

Index de l’étendue.

[in, out] puTextBufSize

L’appelant définit ce paramètre sur le nombre de caractères que la mémoire tampon peut contenir. Une fois la valeur réussie, le nombre de caractères copiés dans la mémoire tampon, y compris la fin NULL , est défini sur le nombre de caractères copiés dans la mémoire tampon.

[out] pszText

Mémoire tampon dans laquelle l’étendue doit être copiée.

Valeur retournée

Cette méthode retourne les valeurs suivantes.

Remarques

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

Configuration requise

Voir aussi

IWbemPath