DeleteNtmsMediaType, fonction (ntmsapi.h)

Article
02/29/2024

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

La fonction DeleteNtmsMediaType supprime la relation de type de média spécifiée de la bibliothèque spécifiée, à condition que la bibliothèque ne contienne aucun objet multimédia physique du type de média spécifié.

Syntaxe

DWORD DeleteNtmsMediaType(
  [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 d’un type de média à supprimer d’une bibliothèque.

[in] lpLibId

Identificateur unique de la bibliothèque à partir de laquelle supprimer le type de média.

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 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 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_PARAMETER	Le type de média ou l’ID de bibliothèque est manquant.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

S’il n’existe aucun objet multimédia physique du type de média spécifié dans le système RSM et qu’aucun objet de bibliothèque ne contient la relation de type de média spécifié dans le système RSM, les pools de supports système pour ce type de média sont supprimés. L’impossibilité de supprimer les pools de médias système n’entraîne pas l’échec de la fonction DeleteNtmsMediaType .

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

AddNtmsMediaType

Fonctions Media Services

Partager via