Funzione DeallocateNtmsMedia (ntmsapi.h)

Articolo
08/25/2023

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

La funzione DeallocateNtmsMedia dealloca il lato associato al supporto logico specificato.

Sintassi

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

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Identificatore univoco del supporto logico (LMID).

dwOptions

Riservati; deve essere zero.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

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	Handle di sessione mancante o non valido.
ERROR_INVALID_MEDIA	LMID non è valido.
ERROR_INVALID_PARAMETER	L'ID del pool multimediale o multimediale non è presente.
ERROR_INVALID_PARTITION	Il lato LMID non è valido.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

Quando un supporto logico viene deallocato con la funzione DeallocateNtmsMedia , RSM inserisce il lato associato al supporto logico nello stato supporto disponibile o rimosso. Il supporto logico viene eliminato dal sistema quando il supporto logico viene deallocato.

I lati vengono rimossi al momento della deallocazione se il lato è stato allocato il numero massimo di volte specificato nel pool di supporti. Dopo che i supporti si trovano nello stato rimosso, non possono essere allocati di nuovo.

Windows Server 2003: Se il supporto viene restituito al pool gratuito, è necessario NTMS_USE_ACCESS al pool gratuito e NTMS_CONTROL_ACCESS al pool di origine. Se il pool gratuito non è il pool multimediale di destinazione, è necessario NTMS_CONTROL_ACCESS nei pool di origine e di destinazione.

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

Condividi tramite