Funzione EjectDiskFromSADriveW (ntmsapi.h)

Articolo
03/05/2024

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

La funzione EjectDiskFromSADrive rimuove il supporto che si trova 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 DI Gestione archiviazione rimovibile (RSM). Se questo parametro è NULL, viene usato 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 esettare. Ad esempio, \.\Cdrom0 o \.\PhysicalDriveX (dove X è il numero dell'unità a cui si accede).

[in] hWnd

Gestire 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 utente.

[in] dwOptions

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

Valore	Significato
NTMS_EJECT_START	Avviare l'operazione di espulsione con una porta. Il supporto specificato viene espulso finché 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 venga scaduto.
NTMS_EJECT_QUEUE	Consentire all'espulso di essere asincrono. La funzione accoda il supporto specificato per l'espulsione e quindi restituisce.
NTMS_EJECT_FORCE	Forzare l'espulso del supporto. Ad esempio, NTFS può contenere blocchi sui supporti e questa opzione causerà l'espulso del supporto nonostante tale blocco.
NTMS_EJECT_IMMEDIATE	Esettare immediatamente il supporto e sincrono. La funzione non restituirà fino al completamento dell'espulso. Non accoda i supporti specificati per l'espulsione.
NTMS_EJECT_ASK_USER	Esettare immediatamente il supporto e sincrono. La funzione non restituirà fino al completamento dell'espulso. Non accoda i supporti specificati per l'espulsione. Se l'operazione di rimozione ha esito negativo, richiedere 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 negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è completo.
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 ID libreria o un puntatore ID operazione.
ERROR_LIBRARY_OFFLINE	L'ID della libreria fa riferimento a una libreria offline che non può esettare 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 ha avuto esito positivo.

Commenti

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

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

Il supporto inserito usando la funzione EjectDiskFromSADrive viene spostato nella libreria offline o eliminato dal database. Importare supporti, supporti non riconosciuti e supporti incompatibili vengono eliminati durante l'eliminazione.

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [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

EjectNtmsMedia

InjectNtmsMedia

Funzioni di controllo della libreria

Condividi tramite