MsiSourceListAddMediaDiskW 関数 (msi.h)

MsiSourceListAddMediaDisk 関数は、登録済み製品またはパッチのメディア ソースのディスクを追加または更新します。 指定したディスクが既に存在する場合は、新しい値で更新されます。 指定したディスクが存在しない場合は、新しい値を使用して新しいディスク エントリが作成されます。

構文

UINT MsiSourceListAddMediaDiskW(
  [in]           LPCWSTR           szProductCodeOrPatchCode,
  [in, optional] LPCWSTR           szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           DWORD             dwDiskId,
  [in]           LPCWSTR           szVolumeLabel,
  [in, optional] LPCWSTR           szDiskPrompt
);

パラメーター

[in] szProductCodeOrPatchCode

製品またはパッチの ProductCode またはパッチ GUID。 null で終わる文字列を使用します。 文字列が 39 文字を超える場合、関数は失敗し、ERROR_INVALID_PARAMETERを返します。 このパラメーターを NULL にすることはできません。

[in, optional] szUserSid

このパラメーターには、製品またはパッチを含むユーザー アカウントを指定する文字列 SID を指定できます。 SID は検証も解決もされません。 SID が正しくないと、ERROR_UNKNOWN_PRODUCTまたはERROR_UNKNOWN_PATCHが返される可能性があります。

[in] dwContext

このパラメーターは、製品またはパッチ インスタンスのコンテキストを指定します。 このパラメーターには、次のいずれかの値を含めることができます。

[in] dwOptions

dwOptions 値は、szProductCodeOrPatchCode の意味を指定します。

[in] dwDiskId

このパラメーターでは、追加または更新されるディスクの ID が提供されます。

[in] szVolumeLabel

szVolumeLabel は、追加または更新されるディスクのラベルを提供します。 更新により、レジストリ内の既存のボリューム ラベルが上書きされます。 ディスク プロンプトのみを変更するには、レジストリから既存のボリューム ラベルを取得し、新しいディスク プロンプトと共にこの呼び出しで指定します。 szVolumeLabel に NULL または空の文字列を渡すと、空の文字列 (長さが 0 バイト) がボリューム ラベルとして登録されます。

[in, optional] szDiskPrompt

MsiSourceListAddMediaDisk へのエントリで、szDiskPrompt によって、追加または更新されるディスクのディスク プロンプトが表示されます。 更新によって、登録されているディスク プロンプトが上書きされます。
ボリューム ラベルのみを変更するには、登録されている既存のディスク プロンプトを取得し、新しいボリューム ラベルと共に MsiSourceListAddMediaDisk を 呼び出すときに指定します。 NULL または空の文字列を渡すと、空の文字列 (長さが 0 バイト) がディスク プロンプトとして登録されます。

戻り値

MsiSourceListAddMediaDisk 関数は、次の値を返します。

注釈

管理者は、マシン コンテキストまたはユーザーごとの独自のコンテキスト (マネージドまたはアンマネージド) の下に存在する製品またはパッチ インスタンスのインストールを変更できます。ユーザーが管理する任意のユーザーのコンテキストの下に存在する製品またはパッチ インスタンスのインストールを変更できます。 管理者は、他のユーザーの非管理対象コンテキストの下に存在する製品またはパッチ インスタンスの別のユーザーのインストールを変更することはできません。

管理者以外のユーザーは、別のユーザーのユーザーごとのコンテキスト (マネージドまたはアンマネージド) の下に存在する製品またはパッチ インスタンスのインストールを変更できません。ユーザーが管理しない独自のコンテキストの下に存在する製品またはパッチ インスタンスのインストールを変更できます。 製品またはパッチ のソースの参照が有効になっている場合にのみ、マシン コンテキストまたは独自のユーザー管理コンテキストで製品またはパッチ インスタンスのインストールを変更できます。 ユーザーは、ポリシーを設定することでソースの参照を有効にすることができます。 詳細については、「 DisableBrowse、 AllowLockdownBrowse、 AllowLockDownMedia 、 AlwaysInstallElevated ポリシー」を参照してください。

要件

こちらもご覧ください

Windows インストーラー 2.0 以前ではサポートされていません

ProductCode