Funzione DismountNtmsMedia (ntmsapi.h)

Articolo
08/25/2023

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

La funzione DismountNtmsMedia accoda un comando per spostare il supporto specificato in un'unità nella relativa risorsa di archiviazione. Questa funzione deve essere associata alla funzione MountNtmsMedia .

Sintassi

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

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Matrice di almeno un lato o un supporto logico.

[in] dwCount

Numero di identificatori multimediali nel parametro lpMediaId .

[in] dwOptions

Opzioni. Questo parametro può essere il valore seguente.

Valore	Significato
NTMS_DISMOUNT_DEFERRED	Contrassegna lo stato del supporto come smontabile e mantiene il supporto nell'unità. Le richieste di montaggio successive vengono soddisfatte usando unità smontate o smontabili. Il valore predefinito è smontare immediatamente.
NTMS_DISMOUNT_IMMEDIATE	Smontare immediatamente l'unità.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_USE_ACCESS al pool di supporti o alla libreria che contiene il supporto viene negato. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_DATABASE_FAILURE	Il database non è accessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è pieno.
ERROR_DEVICE_NOT_AVAILABLE	Una o più risorse necessarie per eseguire il smontaggio non sono attualmente disponibili (probabilmente disabilitate).
ERROR_INVALID_LIBRARY	La libreria che contiene il supporto non è valida.
ERROR_INVALID_MEDIA	Almeno uno dei supporti specificati non è valido.
ERROR_INVALID_STATE	Si è verificato uno stato imprevisto del supporto o del dispositivo durante lo smontaggio.
ERROR_MEDIA_OFFLINE	Il supporto specificato è offline.
ERROR_MEDIA_NOT_AVAILABLE	Una o più risorse multimediali necessarie per eseguire il montaggio non sono attualmente disponibili (probabilmente disabilitate).
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione di memoria durante l'elaborazione.
ERROR_SUCCESS	Lo smontaggio multimediale è stato accodato.
ERROR_TIMEOUT	L'evento di timeout è scaduto mentre l'applicazione ha tentato di acquisire una o più risorse.

Commenti

Un'applicazione deve usare la funzione DismountNtmsMedia per rilasciare la risorsa unità dopo che l'applicazione ha usato il supporto specificato. I supporti non rilasciati non possono essere usati da altre sessioni RSM.

La funzione DismountNtmsMedia restituisce non appena l'operazione viene accodata con RSM. L'applicazione può attendere che lo stato laterale diventi inattiva.

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

Funzioni di Servizi multimediali

MountNtmsMedia

Condividi tramite