Funzione AccessNtmsLibraryDoor (ntmsapi.h)

Articolo
03/05/2024

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

La funzione AccessNtmsLibraryDoor sblocca la porta della libreria specificata. Se la libreria è occupato, RSM accoda la richiesta e restituisce correttamente.

Sintassi

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpLibraryId

Identificatore univoco dell'oggetto libreria. Questa libreria deve supportare l'accesso alle porte.

[in] dwAction

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

Valore	Significato
NTMS_INVENTORY_NONE	Dopo che l'utente chiude la porta, non viene eseguito alcun inventario. Tuttavia, se un controllo dell'etichetta di montaggio ha esito negativo, verrà eseguito un inventario.
NTMS_INVENTORY_OMID	Dopo che l'utente chiude la porta, viene eseguito un inventario multimediale completo. Questo può richiedere molto tempo perché ogni lato di ogni media deve essere montato.
NTMS_INVENTORY_FAST	Se la libreria ha installato un lettore di codice a barre, questo flag causa l'esecuzione dell'inventario del codice a barre. Se la libreria non dispone di un lettore di codice a barre, questo flag causa l'esecuzione di un inventario differenziale. Gli OMID vengono controllati su ogni media posizionata in uno slot vuoto mentre la porta è aperta.
NTMS_INVENTORY_DEFAULT	Usare l'oggetto InventoryMethod specificato nell'oggetto libreria (vedere NTMS_LIBRARYINFORMATION).

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_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è completo.
ERROR_INVALID_HANDLE	L'ID sessione è mancante o non è valido.
ERROR_INVALID_PARAMETER	L'ID della libreria non è presente.
ERROR_LIBRARY_OFFLINE	L'ID libreria fa riferimento a una libreria offline senza una porta.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_RESOURCE_DISABLED	La libreria è disabilitata.
ERROR_RESOURCE_NOT_PRESENT	La libreria non ha una porta.
ERROR_SUCCESS	L'accesso alla porta viene accodato.

Commenti

Alcune librerie non consentono a RSM di bloccare e sbloccare le porte a livello di codice. Il comportamento di questa funzione con queste librerie è identico al suo comportamento con le librerie che RSM può sbloccare e bloccare.

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

InjectNtmsMedia

Funzioni di controllo della libreria

Condividi tramite