Funzione InjectNtmsCleaner (ntmsapi.h)

Articolo
08/25/2023

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

La funzione InjectNtmsCleaner consente l'inserimento di una cartuccia più pulita nell'unità di libreria specificata.

Sintassi

DWORD InjectNtmsCleaner(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpLibrary,
  [in, out] LPNTMS_GUID lpInjectOperation,
  [out]     DWORD       dwNumberOfCleansLeft,
  [in]      DWORD       dwAction
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpLibrary

Identificatore univoco di un oggetto libreria.

[in, out] lpInjectOperation

GUID dell'operazione di libreria dei processi di inserimento. 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.

[out] dwNumberOfCleansLeft

Numero di cicli di pulizia lasciati sulla cartuccia di pulizia inserita.

[in] dwAction

Questo parametro può avere uno dei valori seguenti.

Valore	Significato
NTMS_INJECT_START	Avviare l'inserimento con il NTMS_IEPORT o l'oggetto NTMS_IEDOOR. Deve essere inserita una singola cartuccia di pulizia. Se viene usato l'oggetto NTMS_IEDOOR, non verrà eseguito alcun inventario nella libreria.
NTMS_INJECT_STOP	Termina l'inserimento prima del timeout del timeout. (Solo per le librerie con porte).

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'accesso a almeno un oggetto 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	Impossibile recuperare la definizione della libreria dal database.
ERROR_LIBRARY_OFFLINE	La libreria deve essere online per inserire una cartuccia più pulita.
ERROR_NO_SLOT_SET	Questa libreria non dispone di slot riservati come slot più pulito.
ERROR_SLOT_FULL	Uno slot più pulito è riservato ma ha già una cartuccia più pulita. La cartuccia più pulita deve essere espulsa prima, usando la funzione EjectNtmsCleaner .
ERROR_SLOT_NOT_PRESENT	Uno slot più pulito è riservato, ma lo slot specificato non è attualmente installato nella libreria. Questo errore si verifica se almeno una rivista manca dalla libreria.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

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

Per usare la funzione InjectNtmsCleaner , è necessario specificare il numero di cicli di pulizia che rimangono sulla cartuccia più pulita in modo che RSM possa tenere traccia di esso.

Se è disponibile un oggetto NTMS_IEPORT, l'oggetto NTMS_IEPORT indirizza la cartuccia allo slot più pulito attualmente riservato.

Se non è presente alcun oggetto NTMS_IEPORT, viene eseguito un accesso alla porta. In questo caso, l'operatore viene indirizzato a posizionare il supporto nello slot riservato.

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

CleanNtmsDrive

Funzioni di gestione più pulite

EjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot

Condividi tramite