Condividi tramite


Funzione DecommissionNtmsMedia (ntmsapi.h)

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione DecommissionNtmsMedia sposta un lato dallo stato Disponibile allo stato Rimosso.

Sintassi

DWORD DecommissionNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Identificatore univoco di un lato di un elemento multimediale fisico.

Valore restituito

Valore Significato
ERROR_ACCESS_DENIED
NTMS_CONTROL_ACCESS al pool di supporti del supporto viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.

Windows XP: NTMS_MODIFY_ACCESS al pool di supporti del supporto viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.

ERROR_DATABASE_FAILURE
Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL
Il database è completo.
ERROR_INVALID_HANDLE
L'handle di sessione non è valido o non è valido.
ERROR_INVALID_MEDIA
L'identificatore multimediale non è valido.
ERROR_INVALID_MEDIA_POOL
Il pool di supporti per i supporti non è valido.
ERROR_INVALID_PARAMETER
L'identificatore multimediale non è presente.
ERROR_INVALID_STATE
Il supporto non è nello stato Disponibile.
ERROR_NOT_ENOUGH_MEMORY
Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS
La funzione ha avuto esito positivo.

Commenti

Il supporto rimosso dalla funzione DecommissionNtmsMedia viene riconosciuto da RSM, ma il supporto rimosso non contiene dati e non viene mai più usato.

È possibile rimuovere solo i supporti che si trovano nello stato disponibile. Per altre informazioni, vedere Ciclo di vita multimediale.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntmsapi.h
Libreria Ntmsapi.lib
DLL Ntmsapi.dll

Vedi anche

AllocateNtmsMedia

Funzioni di Servizi multimediali