AddNtmsMediaType, fonction (ntmsapi.h)

Article
03/04/2024

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

La fonction AddNtmsMediaType ajoute le type de média spécifié à la bibliothèque spécifiée s’il n’existe actuellement aucune relation dans l’objet de bibliothèque. La fonction crée ensuite les pools de médias système s’ils n’existent pas.

Syntaxe

DWORD AddNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpMediaTypeId

Identificateur unique du type de média à ajouter à la bibliothèque.

[in] lpLibId

Identificateur unique de la bibliothèque à laquelle le type de média sera ajouté.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS à la bibliothèque est refusée. D’autres erreurs de sécurité sont possibles, mais elles indiquent une erreur de sous-système de sécurité. Windows XP : NTMS_CONTROL_ACCESS à la bibliothèque est refusée. D’autres erreurs de sécurité sont possibles, mais elles indiquent une erreur de sous-système de sécurité.
ERROR_DATABASE_FAILURE	La base de données est inaccessible ou endommagée.
ERROR_DATABASE_FULL	La base de données est pleine.
ERROR_INVALID_HANDLE	Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_LIBRARY	L’ID de bibliothèque n’est pas valide.
ERROR_INVALID_MEDIA	Le type de média n’est pas valide.
ERROR_INVALID_PARAMETER	Le type de média ou l’ID de bibliothèque est manquant.
ERROR_NOT_ENOUGH_MEMORY	Il y a eu un échec d’allocation pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

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

Voir aussi

DeleteNtmsMediaType

Fonctions Media Services

Partager via