Funzione InjectNtmsMedia (ntmsapi.h)

Articolo
03/08/2023

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

La funzione InjectNtmsMedia consente l'inserimento di supporti nella porta della libreria specificata. Se la libreria è occupata, RSM accoda InjectNtmsMedia e restituisce l'esito positivo.

Sintassi

DWORD InjectNtmsMedia(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpLibraryId,
  [out] LPNTMS_GUID lpInjectOperation,
  [in]  DWORD       dwAction
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpLibraryId

Identificatore univoco di un oggetto di libreria.

[out] lpInjectOperation

GUID dell'operazione di inserimento della libreria. Se dwAction è NTMS_INJECT_START, questo parametro riceve il GUID per l'operazione. Se dwAction è NTMS_INJECT_STOP, questo parametro deve essere impostato sul GUID per l'operazione da arrestare.

[in] dwAction

Questo parametro può avere uno dei valori seguenti.

Valore	Significato
NTMS_INJECT_START	Avviare l'operazione di inserimento con una porta. Il supporto viene inserito ripetutamente fino a quando non si verifica l'evento di timeout o la funzione viene chiamata di nuovo con NTMS_INJECT_STOP.
NTMS_INJECT_STOP	Terminare il processo di inserimento prima del ritardo degli eventi di timeout.
NTMS_INJECT_RETRACT	Indirizzare la libreria a ritirare la porta di inserimento/espulsione e verificare la presenza di supporti posizionati dall'operatore.
NTMS_INJECT_START_MANY	Indirizzare la porta di inserimento/espulsione per aprire continuamente e verificare la presenza di supporti posizionati dall'operatore. Se viene trovato un supporto, la porta di inserimento/rimozione viene riaperta per ricevere più supporti.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS alla libreria viene negata. 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	La libreria è disabilitata.
ERROR_INVALID_HANDLE	L'ID di sessione è mancante o non è valido.
ERROR_INVALID_OPERATION	È stata eseguita un'azione Arresta su un ID operazione non valido.
ERROR_INVALID_PARAMETER	Manca l'ID della libreria o il puntatore ID operazione.
ERROR_LIBRARY_OFFLINE	L'ID libreria fa riferimento a una libreria offline che non può espellere il supporto.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	L'inserimento è in coda.

Commenti

Questa funzione torna all'applicazione non appena viene accodata la richiesta di inserimento.

Se la libreria specificata dalla funzione InjectNtmsMedia non dispone di una porta, usare la funzione AccessNtmsLibraryDoor per inserire ed espellere supporti.

Questa funzione non può essere usata con la libreria offline.

L'inserimento inizia il processo di inserimento di supporti in una libreria. Poiché le librerie variano in base alla funzionalità dell'oggetto NTMS_IEPORT, ogni dispositivo può funzionare in modo leggermente diverso. I passaggi seguenti descrivono in che modo RSM gestisce in genere un inserimento:

Per inserire elementi multimediali in una raccolta

Consentire/sbloccare/estendere la NTMS_IEPORT.
Eseguire il polling di un NTMS_IEPORT completo, una NTMS_IEPORT ritirata, un comando Arresta inserimento o un valore di timeout. Se nessuno di questi si è verificato, continuare ad attendere. Le porte di inserimento/espulsione a più munizioni non vengono analizzate per ottenere lo stato completo.
Quando si verifica uno degli eventi precedenti, il NTMS_IEPORT viene bloccato, ogni supporto nel NTMS_IEPORT viene spostato in uno slot e viene accodato un comando medio di identificazione per ogni supporto.

Se non sono presenti slot sufficienti per il supporto nell'oggetto NTMS_IEPORT, i supporti rimangono nell'oggetto NTMS_IEPORT e viene inviata una richiesta di operatore per rimuovere i supporti dalla libreria.

Se non sono presenti slot gratuiti, la funzione InjectNtmsMedia riceve un errore.

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

EjectNtmsMedia

Funzioni di controllo della libreria

Condividi tramite