DismOpenSession 函式
將離線或線上 Windows 映像與 DISMSession產生關聯。
語法
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
參數
ImagePath [in]
將 ImagePath 設定為下列其中一個值：
- 離線 Windows 映像根目錄的絕對或相對路徑。
- 掛接之 Windows 映像根目錄的絕對或相對路徑。 您可以先掛接映射，再呼叫 DismOpenSession ，方法是使用外部工具或使用 DismMountImage。
- DISM_ONLINE_IMAGE 將 會話 與線上 Windows 安裝建立關聯。
WindowsDirectory [in， optional]
選擇性。 Windows 目錄的相對或絕對路徑。 路徑相對於掛接點。
如果 WindowsDirectory 的值是 Null，則會使用預設值 「Windows」。
當ImagePath參數設定為DISM_ONLINE_IMAGE時，無法使用WindowsDirectory參數。
SystemDrive [in， 選擇性]
選擇性。 包含開機管理員的系統磁片磁碟機字母。 如果 SystemDrive 為 Null，則會使用包含掛接點的磁片磁碟機預設值。
當ImagePath參數設定為DISM_ONLINE_IMAGE時，無法使用SystemDrive參數。
會話 [out]
有效的 DismSession。 DismSession 必須與映射相關聯。 您可以使用 DismOpenSession將會話與映射產生關聯。
傳回值
傳回成功 時S_OK 。
如果DismSession已經有與其相關聯的映射，則傳 HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 回 。
傳回對應至 HRESULT 之其他 錯誤的 Win32 錯誤碼。
備註
DismSession可以在DismOpenSession呼叫成功完成之後，用來服務映射。 DismSession 必須藉由呼叫 DismCloseSession來關閉。
範例
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
規格需求
| 需求 | 描述 |
|---|---|
| 支援的主機平臺 | DISM API 可用於 Windows 評定與部署套件所支援的任何作業系統， (Windows ADK) 。 如需詳細資訊，請參閱 Windows ADK 技術參考 |
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 標頭 | DismAPI.h |
| 程式庫 | DismAPI.lib |
| DLL | DismAPI.dll |