DismAddCapability 関数
イメージに機能を追加します。
構文
HRESULT WINAPI DismAddCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_In_ BOOL LimitAccess,
_In_ PCWSTR* SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
パラメーター
Session [in]
有効な DismSession。 DismSession はイメージに関連付けられている必要があります。 DismOpenSessionを使用して、セッションをイメージに関連付けることができます。
Name [in]
追加する機能の名前。
LimitAccess [in]
このフラグは、機能のペイロードをダウンロードするためのソースの場所として WU/WSUS に接続する必要があるかどうかを示します。 追加する機能のペイロードが存在する場合、フラグは無視されます。
SourcePaths [in]
ソースの場所の一覧。 この関数は、SourcePaths で指定された場所から削除されたペイロード ファイルを検索し、見つからない場合は、パラメーター LimitAccess に応じて WU/WSUS に問い合わせて検索を続行します。
SourcePathCount [in, optional]
SourcePaths 内のエントリの数。
CancelEvent [in, optional]
これは、取り消し用のイベントへのハンドルです。
Progress [in, optional]
進行状況を報告するクライアント定義コールバック関数へのポインター。
UserData [in, optional]
ユーザー定義のカスタム データ。 これはコールバックを通じてユーザーに返されます。
戻り値
関数が成功した場合、戻り値は S_OK。 関数が成功すると、次のいずれかの値が返される場合もあります。
| リターン コード | 説明 |
|---|---|
|
セッション がオンラインの場合は、コンピューターを再起動する必要があります。 |
|
セッション を再読み込みする必要があります。 |
関数が失敗した場合、戻り値は HRESULT エラー値です。
解説
この関数を使用して、機能を追加します。
例
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, NULL, NULL, NULL);
必要条件
| 要件 | 説明 |
|---|---|
| サポートされているホスト プラットフォーム | DISM API は、Windows Assessment and Deployment Kit (Windows ADK) でサポートされている任意のオペレーティング システムで使用できます。 詳細については、Windows ADK テクニカル リファレンスを参照してください。 |
| サポートされているイメージ プラットフォーム | Windows 10、Windows Server 2016 |
| サポートされる最小クライアント | Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小サーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| ヘッダ | DismAPI.h |
| 図書館 | DismAPI.lib |
| DLL | DismAPI.dll |