Funzione AccessNtmsLibraryDoor (ntmsapi.h)
[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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Usare l'oggetto InventoryMethod specificato nell'oggetto libreria (vedere NTMS_LIBRARYINFORMATION). |
Valore restituito
Questa funzione restituisce uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
NTMS_CONTROL_ACCESS alla libreria viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza. |
|
Il database è inaccessibile o danneggiato. |
|
Il database è completo. |
|
L'ID sessione è mancante o non è valido. |
|
L'ID della libreria non è presente. |
|
L'ID libreria fa riferimento a una libreria offline senza una porta. |
|
Si è verificato un errore di allocazione durante l'elaborazione. |
|
La libreria è disabilitata. |
|
La libreria non ha una porta. |
|
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 |