Funzione EjectDiskFromSADriveW (ntmsapi.h)

Articolo
11/20/2024

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

La funzione EjectDiskFromSADrive inserisce il supporto in un'unità rimovibile autonoma.

Sintassi

DWORD EjectDiskFromSADriveW(
  [in] LPCWSTR lpComputerName,
  [in] LPCWSTR lpAppName,
  [in] LPCWSTR lpDeviceName,
  [in] HWND    hWnd,
  [in] LPCWSTR lpTitle,
  [in] LPCWSTR lpMessage,
  [in] DWORD   dwOptions
);

Parametri

[in] lpComputerName

Nome del server RSM (Removable Storage Manager). Se questo parametro è NULL, viene utilizzato il nome del computer corrente.

[in] lpAppName

Stringa di caratteri univoca che identifica l'applicazione. Questo nome identifica le risorse e le richieste dell'operatore. Questo parametro è facoltativo e può essere NULL.

[in] lpDeviceName

Nome del dispositivo da espellere. Ad esempio, \.\Cdrom0 o \.\PhysicalDriveX (dove X è il numero dell'unità a cui si accede).

[in] hWnd

Handle in una finestra di dialogo per la conferma dell'utente.

[in] lpTitle

Titolo visualizzato in una finestra di dialogo per ottenere l'input dell'utente.

[in] lpMessage

Messaggio visualizzato in una finestra di dialogo per ottenere l'input dell'utente.

[in] dwOptions

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

Valore	Significato
NTMS_EJECT_START	Avviare l'operazione di inserimento con una porta. Il supporto specificato viene espulso fino a quando non si verifica l'evento di timeout o la funzione viene chiamata di nuovo 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	Terminare il processo di espulsione prima che l'evento di timeout termini.
NTMS_EJECT_QUEUE	Consente all'eject di essere asincrono. La funzione accoda il supporto specificato per l'eiettazione e quindi restituisce.
NTMS_EJECT_FORCE	Forzare l'espulsore il supporto. Ad esempio, NTFS può contenere blocchi sui supporti e questa opzione causerà l'espulso del supporto nonostante tale blocco.
NTMS_EJECT_IMMEDIATE	Espellere i supporti immediatamente e in modo sincrono. La funzione non verrà restituita fino al completamento dell'eject. Non accoda il supporto specificato per l'espulsione.
NTMS_EJECT_ASK_USER	Espellere i supporti immediatamente e in modo sincrono. La funzione non verrà restituita fino al completamento dell'eject. Non accoda il supporto specificato per l'espulsione. Se l'operazione di inserimento non riesce, chiedere all'utente di annullare o forzare l'operazione.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS alla libreria viene negata. Sono anche possibili altri errori di sicurezza, ma indicano un errore del sottosistema di sicurezza.
ERROR_DATABASE_FAILURE	Il database non è accessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è pieno.
ERROR_DEVICE_NOT_AVAILABLE	La libreria è disabilitata.
ERROR_INVALID_HANDLE	L'ID sessione è mancante o non è valido.
ERROR_INVALID_OPERATION	Un arresto è stato eseguito su un ID operazione non valido.
ERROR_INVALID_PARAMETER	Manca un PUNTATORE ID libreria o ID operazione.
ERROR_LIBRARY_OFFLINE	L'ID di libreria fa riferimento a una libreria offline che non può espellere supporti.
ERROR_MEDIA_NOT_AVAILABLE	Il supporto è disabilitato.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_SUCCESS	L'operazione di rimozione è riuscita.

Osservazioni

Anche se EjectNtmsMedia può, in alcuni casi, essere usato per eseguire la stessa funzionalità, EjectDiskFromSADrive offre un modo pratico per espellere supporti da un dispositivo autonomo, specificando il nome dell'unità anziché il nome RSM. In alcuni casi è l'unico modo per superare i blocchi del file system sui supporti per espellere tale supporto.

La funzione EjectDiskFromSADrive torna all'applicazione non appena viene accodata la richiesta di inserimento, a meno che non venga specificata NTMS_EJECT_IMMEDIATE opzione.

I supporti espulsi tramite la funzione EjectDiskFromSADrive vengono spostati nella libreria offline o eliminati dal database. Importare supporti, supporti non riconosciuti e supporti incompatibili vengono eliminati quando vengono inseriti.

La funzione EjectDiskFromSADrive non funziona con la libreria offline.

Nota

L'intestazione ntmsapi.h definisce EjectDiskFromSADrive come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ntmsapi.h
libreria	Ntmsapi.lib
dll	Ntmsapi.dll

Vedere anche

EjectNtmsMedia

InjectNtmsMedia

Funzioni di controllo della libreria

Condividi tramite