DismCloseSession 関数

  • [アーティクル]

構文

HRESULT WINAPI DismCloseSession(
  _In_ DismSession Session
);

パラメーター

Session [in]
有効な DismSession。 DismSession はイメージに関連付けられている必要があります。 セッションをイメージに関連付けるには、DismOpenSession を使用します。

戻り値

成功すると S_OK が返されます。

DISMSession によって他のスレッドで操作が実行されている場合、それらの操作は DISMSession が破棄される前に完了します。 DismCloseSession が呼び出された後、しかし DismCloseSession が返される前に他のスレッドによって追加の操作が呼び出された場合は、それらの操作は失敗して DISMAPI_E_INVALID_DISM_SESSION エラーが返されます。

解説

この呼び出しが完了した後に DISMSession はシャットダウンされますが、イメージのマウントは解除されません。 イメージをマウント解除するには、すべてのセッションが閉じた後で DismUnmountImage を使用します。

例

HRESULT hr = S_OK;
DismSession session;
hr = DismOpenSession( DISM_ONLINE_IMAGE, NULL, NULL, &session ); hr = DismCloseSession( session );

必要条件

要件 説明
サポートされているホスト プラットフォーム DISM API は、Windows アセスメント & デプロイメント キット (Windows ADK) でサポートされているすべてのオペレーティング システムで使用できます。 詳細については、Windows ADK のテクニカル リファレンスに関するページを参照してください。
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header DismAPI.h
ライブラリ DismAPI.lib
[DLL] DismAPI.dll

関連項目

DismOpenSession

DISMSession