Funzione EjectNtmsCleaner (ntmsapi.h)

Articolo
08/25/2023

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

La funzione EjectNtmsCleaner espelle la stampante di pulizia dallo slot attualmente pulitore.

Sintassi

DWORD EjectNtmsCleaner(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpLibrary,
  [in, out] LPNTMS_GUID lpEjectOperation,
  [in]      DWORD       dwAction
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpLibrary

Identificatore univoco di un oggetto di libreria.

[in, out] lpEjectOperation

GUID dell'operazione di rimozione della libreria di processi. Se dwAction è NTMS_EJECT_START, questo parametro riceve il GUID per l'operazione. Se dwAction è NTMS_EJECT_STOP, questo parametro deve essere impostato sul GUID per l'operazione da arrestare.

[in] dwAction

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

Valore	Significato
NTMS_EJECT_START	Avvia l'operazione di rimozione con una porta. Il supporto specificato viene espulso fino a quando non si verifica l'evento di timeout o la funzione viene chiamata nuovamente con NTMS_EJECT_STOP. Il valore di timeout viene specificato nell'oggetto libreria e viene applicato a tutte le esezioni nella libreria.
NTMS_EJECT_STOP	Solo per le librerie con oggetti NTMS_IEPORT. Termina il processo di espulsione specificato da lpEjectOperation prima del ritardo dell'evento di timeout.

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_INVALID_HANDLE	Il valore specificato nel parametro hSession non è valido.
ERROR_INVALID_LIBRARY	Impossibile recuperare la definizione della libreria dal database.
ERROR_NO_SLOT_SET	Questa libreria non dispone di uno slot più pulito riservato.
ERROR_NOT_CONNECTED	Impossibile connettersi al servizio RSM.
ERROR_SLOT_EMPTY	Uno slot più pulito è riservato ma è già vuoto.
ERROR_SLOT_NOT_PRESENT	Uno slot più pulito è riservato, ma lo slot non è attualmente installato nella libreria. Questo errore si verifica quando almeno una rivista non è presente nella libreria.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

La funzione EjectNtmsCleaner torna all'applicazione non appena la richiesta di espulsione viene accodata.

Se la libreria specificata nella funzione EjectNtmsCleaner ha un oggetto NTMS_IEPORT, RSM usa l'oggetto NTMS_IEPORT per espellere il pulitore. Se non è presente alcun oggetto NTMS_IEPORT, l'oggetto NTMS_IEDOOR viene utilizzato per consentire all'operatore di accedere allo slot più pulito.

Le munizioni di pulitura espulse non vengono rilevate nella libreria offline.

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 di Cleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot

Condividi tramite