Funzione SetNtmsMediaComplete (ntmsapi.h)

Articolo
02/29/2024

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

La funzione SetNtmsMediaComplete contrassegna una parte di supporti logici come completa.

Sintassi

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

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Identificatore univoco di un elemento multimediale logico.

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	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 il supporto non è valido.
ERROR_INVALID_PARAMETER	L'identificatore multimediale non è presente.
ERROR_INVALID_STATE	Il supporto non è nello stato allocato o è attualmente montato.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

La funzione SetNtmsMediaComplete contrassegna il supporto specificato come Complete. Un'applicazione contrassegna il supporto completo quando l'applicazione non scriverà più nel supporto. Impossibile montare supporti completi con il flag di NTMS_MOUNT_WRITE.

La funzione SetNtmsMediaComplete viene in genere usata quando un'applicazione raggiunge la fine dei supporti. I supporti montati o in uso non possono essere contrassegnati come completi.

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