Condividi tramite


Funzione InventoryNtmsLibrary (ntmsapi.h)

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

La funzione InventoryNtmsLibrary accoda un inventario della libreria specificata. Se la libreria è occupata, RSM accoda InventoryNtmsLibrary e restituisce l'esito positivo.

Sintassi

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

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpLibraryId

Identificatore univoco di un oggetto di libreria.

[in] dwAction

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

Valore Significato
NTMS_INVENTORY_OMID
Viene eseguito un inventario multimediale completo. Ogni lato di ogni supporto deve essere montato in un'unità. Si tratta di un processo che richiede molto tempo.
NTMS_INVENTORY_FAST
Se nella libreria è installato un lettore di codice a barre, questo flag determina l'esecuzione di un inventario con codice a barre. Se la libreria non dispone di un lettore di codice a barre, questo flag determina l'esecuzione di un inventario differenziale (gli slot vengono classificati).
NTMS_INVENTORY_DEFAULT
Utilizzare inventoryMethod specificato nell'oggetto libreria (vedere NTMS_LIBRARYINFORMATION).
NTMS_INVENTORY_STOP
Arrestare l'inventario corrente nella libreria specificata.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore Significato
ERROR_ACCESS_DENIED
L'accesso a uno o più oggetti RSM viene negato.
ERROR_DEVICE_NOT_AVAILABLE
La libreria non è attualmente connessa.
ERROR_INVALID_HANDLE
Il valore specificato nel parametro hSession non è valido.
ERROR_INVALID_LIBRARY
La libreria è la libreria offline.
ERROR_INVALID_PARAMETER
L'ID della libreria o l'ID sessione non è valido.
ERROR_NOT_CONNECTED
Impossibile connettersi al servizio RSM.
ERROR_SUCCESS
La funzione ha avuto esito positivo.

Commenti

Non è possibile eseguire l'inventario delle librerie non presenti.

La funzione InventoryNtmsLibrary contrassegna tutti gli slot che attualmente contengono un supporto nella libreria per la classificazione/identificazione. La funzione InventoryNtmsLibrary restituisce quando tutti i supporti sono contrassegnati.

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

AccessNtmsLibraryDoor

Funzioni di controllo della libreria