Funzione DeleteNtmsMedia (ntmsapi.h)

Articolo
03/05/2024

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

La funzione DeleteNtmsMedia elimina una parte fisica di supporti offline da RSM rimuovendo tutti i riferimenti ai supporti specificati dal database.

Sintassi

DWORD DeleteNtmsMedia(
  [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 fisico.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS al computer o 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 è offline.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

I supporti specificati dalla funzione DeleteNtmsMedia devono trovarsi in una libreria offline e non hanno un lato negli stati allocati, completati o riservati.

È possibile usare DeleteNtmsMedia per rimuovere supporti persi o eliminati.

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

Condividi tramite