GetNtmsMediaPoolNameW, fonction (ntmsapi.h)
[Le Gestionnaire de stockage amovible n’est plus disponible à partir de Windows 7 et Windows Server 2008 R2.]
La fonction GetNtmsMediaPoolName récupère la hiérarchie de noms complets du pool de médias spécifié.
Syntaxe
DWORD GetNtmsMediaPoolNameW(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpPoolId,
[out] LPWSTR 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 médias dont le nom doit être récupéré.
[out] lpNameBuf
Pointeur vers une mémoire tampon qui reçoit le nom du pool de médias.
[in, out] lpdwBufSize
Taille de la mémoire tampon lpBufName , en entrée. En sortie, le nombre de caractères dans la hiérarchie de noms complets.
Valeur retournée
Cette fonction retourne l’une des valeurs suivantes.
Valeur | Signification |
---|---|
|
La taille de la mémoire tampon n’est pas suffisante. La taille correcte est retournée dans lpdwBufSize. |
|
La valeur spécifiée dans le paramètre hSession est NULL ou n’est pas valide. |
|
L’ID du pool de médias est manquant ou n’est pas valide. |
|
Le paramètre est manquant ou n’est pas valide. |
|
L’allocation de mémoire a échoué. |
|
La fonction a réussi. |
Remarques
Notes
L’en-tête ntmsapi.h définit GetNtmsMediaPoolName comme un 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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | ntmsapi.h |
Bibliothèque | Ntmsapi.lib |
DLL | Ntmsapi.dll |