共用方式為

EjectDiskFromSADriveA 函式 （ntmsapi.h）

  • 發行項

[ 從 Windows 7 和 Windows Server 2008 R2 起，卸除式存儲設備管理員 已無法使用。]

EjectDiskFromSADrive 函式會退出獨立卸載式磁碟驅動器中的媒體。

語法

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

參數

[in] lpComputerName

卸除式存放設備管理員 （RSM） 伺服器名稱。 如果此參數 NULL，則會使用目前的電腦名稱。

[in] lpAppName

識別應用程式的唯一字元字串。 此名稱會識別資源和操作員要求。 這個參數是選擇性的，而且可能會 NULL。

[in] lpDeviceName

要退出的裝置名稱。 例如，\.\Cdrom0 或 \.\PhysicalDriveX（其中 X 是所存取的磁碟驅動器數目）。

[in] hWnd

使用者確認的對話框視窗句柄。

[in] lpTitle

顯示於對話框中的標題，以取得用戶輸入。

[in] lpMessage

顯示在對話框中的訊息，以取得用戶輸入。

[in] dwOptions

要執行的動作。 此參數可以是下列其中一個值。

價值 意義
NTMS_EJECT_START
 使用埠啟動退出作業。 指定的媒體會遭到退出，直到發生逾時事件，或使用 NTMS_EJECT_STOP再次呼叫 函式。 逾時值是在連結庫物件中指定，並套用至連結庫中的所有退出。
NTMS_EJECT_STOP
 在逾時事件失效之前終止退出程式。
NTMS_EJECT_QUEUE
 允許退出為異步。 函式會指定的媒體排入佇列以供退出，然後傳回 。
NTMS_EJECT_FORCE
 強制媒體被逐出。 例如，NTFS 可以保留媒體上的鎖定，而且此選項會導致媒體儘管有鎖定，仍會退出媒體。
NTMS_EJECT_IMMEDIATE
 立即和同步地退出媒體。 在退出完成之前，函式將不會傳回。 不會將指定的媒體排入佇列以退出。
NTMS_EJECT_ASK_USER
 立即和同步地退出媒體。 在退出完成之前，函式將不會傳回。 不會將指定的媒體排入佇列以退出。 如果退出作業失敗，請提示使用者取消或強制作業。

傳回值

此函式會傳回下列其中一個值。

價值 意義
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS連結庫遭到拒絕。 也可能發生其他安全性錯誤，但會指出安全性子系統錯誤。
ERROR_DATABASE_FAILURE
 資料庫無法存取或損毀。
ERROR_DATABASE_FULL
 資料庫已滿。
ERROR_DEVICE_NOT_AVAILABLE
 連結庫已停用。
ERROR_INVALID_HANDLE
 會話標識碼遺失或無效。
ERROR_INVALID_OPERATION
 停止是在無效的作業標識碼上執行。
ERROR_INVALID_PARAMETER
 缺少連結庫標識碼或作業標識碼指標。
ERROR_LIBRARY_OFFLINE
 連結庫標識碼是指無法退出媒體的離線連結庫。
ERROR_MEDIA_NOT_AVAILABLE
 媒體已停用。
ERROR_NOT_ENOUGH_MEMORY
 處理期間發生配置失敗。
ERROR_SUCCESS
 退出作業成功。

言論

雖然 射出NtmsMedia 在某些情況下，可以用來完成相同的功能，EjectDiskFromSADrive 提供方便的方式，藉由指定其磁碟驅動器名稱而非 RSM 名稱，從獨立裝置中退出媒體。 在某些情況下，這是克服媒體上的文件系統鎖定，以退出該媒體的唯一方法。

除非指定 NTMS_EJECT_IMMEDIATE 選項，否則 EjectDiskFromSADrive 函式會在退出要求排入佇列後立即傳回應用程式。

使用 EjectDiskFromSADrive 函式退出的媒體會移至離線連結庫，或從資料庫刪除。 在退出時，會刪除媒體、無法辨識的媒體和不相容的媒體。

EjectDiskFromSADrive 函式不適用於離線連結庫。

注意

ntmsapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 EjectDiskFromSADrive 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 ntmsapi.h
連結庫 Ntmsapi.lib
DLL Ntmsapi.dll

另請參閱

退出NtmsMedia

InjectNtmsMedia

連結庫控制函式