MsiEnumClientsExA 関数 (msi.h)
MsiEnumClientsEx 関数は、指定したコンポーネントを使用するインストール済みアプリケーションを列挙します。 この関数は、呼び出されるたびに、アプリケーションの 製品コード を取得します。
Windows インストーラー 4.5 以前の: サポートされていません。 この関数は、Windows インストーラー 5.0 以降で使用できます。
構文
UINT MsiEnumClientsExA(
[in] LPCSTR szComponent,
[in, optional] LPCSTR szUserSid,
[in] DWORD dwContext,
[in] DWORD dwProductIndex,
[out, optional] CHAR [39] szProductBuf,
[out, optional] MSIINSTALLCONTEXT *pdwInstalledContext,
[out, optional] LPSTR szSid,
[in, out, optional] LPDWORD pcchSid
);
パラメーター
[in] szComponent
コンポーネントを識別するコンポーネント コード GUID。 この関数は、このコンポーネントを使用するアプリケーションを列挙します。
[in, optional] szUserSid
セキュリティ識別子 (SID) を含む null で終わる文字列値。アプリケーションの列挙は、この SID によって識別されるユーザーに拡張されます。 特殊な SID 文字列 s-1-1-0 (Everyone) は、システム内のすべてのユーザーのすべてのアプリケーションを列挙します。 s-1-1-0 以外の SID 値は、特定のユーザーのユーザー SID を指定し、指定したユーザーによってインストールされたアプリケーションのインスタンスを列挙します。
SID の種類 | 意味 |
---|---|
|
現在ログオンしているユーザーを指定します。 |
|
特定のユーザーの列挙体を指定します。 ユーザー SID の例として、"S-1-3-64-2415071341-1358098788-3127455600-2561" があります。 |
|
システム内のすべてのユーザーの列挙を指定します。 |
[in] dwContext
指定したインストール コンテキストでインストールされているアプリケーションのインスタンスに列挙を拡張するフラグ。 列挙には、szUserSidによって識別されたユーザーによってインストールされるアプリケーションのインスタンスのみが含まれます。
これは、次の値の組み合わせにすることができます。
[in] dwProductIndex
取得するアプリケーションのインデックスを指定します。 このパラメーターの値は、関数の最初の呼び出しでゼロ (0) にする必要があります。 後続の呼び出しごとに、インデックスを 1 ずつインクリメントする必要があります。 インデックスは、前の関数の呼び出しが ERROR_SUCCESSを返す場合にのみインクリメントする必要があります。
[out, optional] szProductBuf
アプリケーションの製品コードを受け取る文字列値。 この場所のバッファーの長さは、製品コードを含む null で終わる文字列値を保持するのに十分な大きさにする必要があります。 最初の 38 TCHAR 文字はコンポーネントの GUID を受け取り、39 番目の文字は終端の NULL 文字を受け取ります。
[out, optional] pdwInstalledContext
アプリケーションのインストール コンテキストを示すフラグ。
これは、次の値の組み合わせにすることができます。
[out, optional] szSid
アプリケーションをインストールしたユーザーを識別するセキュリティ識別子 (SID) を受け取ります。 アプリケーションのこのインスタンスがマシンごとのインストール コンテキストに存在する場合、場所は空の文字列値を受け取ります。
バッファーの長さは、SID を含む null で終わる文字列値を保持するのに十分な大きさにする必要があります。 バッファーが小さすぎる場合、関数は
SID の種類 | 意味 |
---|---|
|
アプリケーションは、コンピューターごとのインストール コンテキストでインストールされます。 |
|
製品をインストールしたユーザーの SID。 |
[in, out, optional] pcchSid
SID 内の TCHAR の数を指定する変数を含むメモリ内の場所へのポインター。終端の null 文字は含まれません。 関数が戻るときに、関数が SID を正常にコピーし、szSidが指すバッファー位置に null 文字を終了できるかどうかに関係なく、この変数は要求された SID のサイズ
このパラメーターは、
戻り値
MsiEnumClientsEx 関数は、次のいずれかの値を返します。
リターン コード | 形容 |
---|---|
|
現在のユーザー以外のユーザーによってインストールされたアプリケーションのコンポーネントを列挙するには、Administratator 特権が必要です。 |
|
構成データが破損しています。 |
|
無効なパラメーターが関数に渡されます。 |
|
列挙するアプリケーションはこれ以上ありません。 |
|
関数は成功しました。 |
|
指定されたバッファーが小さすぎて値全体を保持できませんでした。 |
|
関数が失敗しました。 |
備考
手記
msi.h ヘッダーは、MSIEnumClientsEx をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows インストーラーのバージョンで必要な最小 Windows Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。 |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | msi.h |
ライブラリ | Msi.lib |
DLL | Msi.dll |