DismGetPackageInfo 関数
標準のパッケージ プロパティを DismGetPackages として取得し、より具体的なパッケージ情報とカスタム プロパティを取得します。
構文
HRESULT WINAPI DismGetPackageInfo(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_Out_ DismPackageInfo **PackageInfo
);
パラメーター
Session [in]
有効な DismSession。 DismSession はイメージに関連付けられている必要があります。 セッションをイメージに関連付けるには、DismOpenSession を使用します。
Identifier [in]
PackageIdentifier パラメーター値に応じて、.cab ファイルへの絶対パスまたはパッケージ名のいずれか。
PackageIdentifier [in]
有効な DismPackageIdentifier 列挙値。
| 値 | 説明 |
|---|---|
| PackageName | パッケージ名を使用してパッケージを指定する場合は、この値を使用します。 |
| PackagePath | .cab ファイルまたは展開されたパッケージを含むフォルダーへの絶対パスを使用してパッケージを指定する場合は、この値を使用します。 |
| PackageNone | この関数に有効な値ではありません。 |
PackageInfo [out]
DismPackageInfo 構造体の配列のアドレスへのポインター。
戻り値
成功すると S_OK を返します。
注釈
この関数を使用すると、パッケージが指定したイメージに適用可能かどうかを判断できます。 DismPackageInfo 構造体には、適用可能 フィールドが含まれています。これは、パッケージが指定したイメージに適用可能な場合は TRUE を返し、パッケージが指定したイメージに適用可能ではない場合は FALSE を返すブール値です。
例
HRESULT hr = S_OK;
DismPackageInfo PackageInfo;
hr = DismGetPackageInfo(Session, "C:\packages\calc.cab", PackagePath, &PackageInfo);
必要条件
| 要件 | 説明 |
|---|---|
| サポートされているホスト プラットフォーム | DISM API は、Windows アセスメント & デプロイメント キット (Windows ADK) でサポートされているすべてのオペレーティング システムで使用できます。 詳細については、Windows ADK のテクニカル リファレンスに関するページを参照してください。 |
| サポートされているイメージ プラットフォーム | Windows 7、Windows Server 2008 R2、Windows PE 3.0、Windows 8、Windows Server 2012、Windows プレインストール環境 (Windows PE) 4.0、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016 |
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header | DismAPI.h |
| ライブラリ | DismAPI.lib |
| [DLL] | DismAPI.dll |