DeleteNtmsMediaPool, fonction (ntmsapi.h)

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

La fonction DeleteNtmsMediaPool supprime le pool de médias d’application spécifié.

Syntaxe

DWORD DeleteNtmsMediaPool(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpPoolId
);

Paramètres

[in] hSession

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

[in] lpPoolId

Identificateur unique du pool de supports.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
NTMS_MODIFY_ACCESS au pool de médias est refusé. D’autres erreurs de sécurité sont également possibles, mais elles indiquent une erreur de sous-système de sécurité.

Windows XP : NTMS_CONTROL_ACCESS au pool de supports est refusé. D’autres erreurs de sécurité sont également 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_INVALID_HANDLE
Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_MEDIA_POOL
Impossible d’ouvrir le pool de médias existant ou de tenter de supprimer des pools de médias gratuits, importés ou non reconnus.
ERROR_INVALID_PARAMETER
L’ID du pool de médias est manquant.
ERROR_NOT_EMPTY
Le pool de médias doit être vide pour être supprimé.
ERROR_NOT_ENOUGH_MEMORY
Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS
La fonction a réussi.

Remarques

Seuls les pools de médias vides peuvent être supprimés avec la fonction DeleteNtmsMediaPool .

Les pools de médias gratuits, non reconnus et d’importation sont gérés par RSM et ne peuvent pas être supprimés avec DeleteNtmsMediaPool.

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

CreateNtmsMediaPool

Fonctions Media Services

MoveToNtmsMediaPool