GetNtmsMediaPoolNameA, fonction (ntmsapi.h)

Article
11/20/2024

[Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction GetNtmsMediaPoolName récupère la hiérarchie de nom complet du pool de médias spécifié.

Syntaxe

DWORD GetNtmsMediaPoolNameA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpPoolId,
  [out]     LPSTR       lpNameBuf,
  [in, out] LPDWORD     lpdwBufSize
);

Paramètres

[in] hSession

Gérez la session retournée par la fonction OpenNtmsSession.

[in] lpPoolId

Identificateur unique du pool de supports dont le nom doit être récupéré.

[out] lpNameBuf

Pointeur vers une mémoire tampon qui reçoit le nom du pool de supports.

[in, out] lpdwBufSize

Taille de la mémoire tampon lpBufName, en entrée. En sortie, nombre de caractères dans la hiérarchie de noms complets.

Valeur de retour

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_INSUFFICIENT_BUFFER	La taille de la mémoire tampon n’est pas assez grande. La taille correcte est retournée dans lpdwBufSize.
ERROR_INVALID_HANDLE	La valeur spécifiée dans le paramètre hSession est NULL ou n’est pas valide.
ERROR_INVALID_MEDIA_POOL	L’ID du pool de supports est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER	Le paramètre est manquant ou n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	Échec de l’allocation de mémoire.
ERROR_SUCCESS	La fonction a réussi.

Remarques

Note

L’en-tête ntmsapi.h définit GetNtmsMediaPoolName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	ntmsapi.h
bibliothèque	Ntmsapi.lib
DLL	Ntmsapi.dll

Voir aussi

CreateNtmsMediaPool

fonctions Media Services

Partager via