Funzione EjectNtmsMedia (ntmsapi.h)

  • Articolo

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

La funzione EjectNtmsMedia rimuove il supporto specificato dalla porta della libreria corrente. Se la libreria è occupato, le code RSM EjectNtmsMedia e restituisce esito positivo.

Sintassi

DWORD EjectNtmsMedia(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpMediaId,
  [in, out] LPNTMS_GUID lpEjectOperation,
  [in]      DWORD       dwAction
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Identificatore univoco di un elemento multimediale fisico (PMID).

[in, out] lpEjectOperation

GUID della richiesta di libreria di processi espulsi. Se dwAction è NTMS_EJECT_START, questo parametro riceve il GUID per l'operazione. Se dwAction è NTMS_EJECT_STOP, questo parametro deve essere impostato sul GUID per l'operazione da arrestare. Questo parametro non viene usato con NTMS_EJECT_QUEUE.

[in] dwAction

Azione da eseguire. Questo parametro può avere uno dei valori seguenti.

Valore Significato
NTMS_EJECT_START
 Avviare l'operazione di espulsione con una porta. Il supporto specificato viene espulso finché non si verifica l'evento di timeout o la funzione viene chiamata di nuovo con NTMS_EJECT_STOP. Il valore di timeout viene specificato nell'oggetto libreria e viene applicato a tutte le esezioni nella libreria.
NTMS_EJECT_STOP
 Terminare il processo di espulsione specificato da lpEjectOperation prima che l'evento di timeout venga scaduto.
NTMS_EJECT_QUEUE
 Accodamento del supporto specificato per l'espulsione. Usato per raggruppare i supporti per oggetti NTMS_IEPORT multi slot.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore Significato
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS alla libreria viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_BUSY
 Più supporti sono stati accodati rispetto agli slot disponibili nell'oggetto NTMS_IEPORT.
ERROR_DATABASE_FAILURE
 Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL
 Il database è completo.
ERROR_DEVICE_NOT_AVAILABLE
 La libreria è disabilitata.
ERROR_INVALID_HANDLE
 L'ID sessione è mancante o non è valido.
ERROR_INVALID_OPERATION
 Un arresto è stato eseguito su un ID operazione non valido.
ERROR_INVALID_PARAMETER
 Manca un ID libreria o un puntatore ID operazione.
ERROR_LIBRARY_OFFLINE
 L'ID della libreria fa riferimento a una libreria offline che non può esettare supporti.
ERROR_MEDIA_NOT_AVAILABLE
 Il supporto è disabilitato.
ERROR_NOT_ENOUGH_MEMORY
 Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS
 L'espulso viene accodato.

Commenti

La funzione EjectNtmsMedia restituisce all'applicazione non appena la richiesta espulsa viene accodata.

Il supporto inserito usando la funzione EjectNtmsMedia viene spostato nella libreria offline o eliminato dal database. Le cartucce più pulite, i supporti di importazione, i supporti non riconosciuti e i supporti incompatibili vengono eliminati durante l'espulso.

Il flag NTMS_EJECT_QUEUE viene usato per raggruppare o inserire supporti batch contrassegnati per l'inserimento in una libreria multi-slot. È possibile accodamento multimediale per l'espulsione usando l'azione coda quando l'applicazione ha accodato tutti i supporti necessari. L'applicazione usa il comando start per avviare l'operazione di espulsione fisica. Se più supporti vengono accodati rispetto agli slot nell'oggetto NTMS_IEPORT, EjectNtmsMedia restituisce ERROR_BUSY. Per iniziare l'operazione di espulsione fisica, l'applicazione può usare NTMS_EJECT_START con l'ultimo ID multimediale o NULL.

Se il supporto è attualmente in uso (montato o aperto), questa funzione restituisce un errore.

Se la libreria non ha una porta, usare la funzione AccessNtmsLibraryDoor per inserire ed esettare supporti.

La funzione EjectNtmsMedia non funziona con la libreria offline.

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

InjectNtmsMedia

Funzioni di controllo della libreria