SetupSetSourceListA 関数 (setupapi.h)

[アーティクル]
11/20/2024

[この機能は、[要件] セクションに示されているオペレーティングシステムで使用できます。以降のバージョンでは、変更または使用できない場合があります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。代わりに、Windows インストーラーを使用してアプリケーションインストーラーを開発します。 SetupAPI は、デバイスドライバーのインストールに引き続き使用されます。

SetupSetSourceList 関数を使用すると、呼び出し元は現在のユーザーまたはシステム (すべてのユーザーに共通) のインストールソースの一覧を設定できます。

構文

WINSETUPAPI BOOL SetupSetSourceListA(
  [in] DWORD Flags,
  [in] PCSTR *SourceList,
  [in] UINT  SourceCount
);

パラメーター

[in] Flags

リストの種類を指定します。このパラメーターには、次の値の組み合わせを指定できます。

SRCLIST_SYSTEM

この一覧は、レジストリに格納されているシステムごとの最近使用された (MRU) リストです。呼び出し元は、管理者ローカルグループのメンバーである必要があります。

SRCLIST_USER

この一覧は、レジストリに格納されているユーザーごとの MRU リストです。

SRCLIST_TEMPORARY

指定したリストは一時的なリストであり、SetupCancelTemporarySourceList が呼び出されるか、SetSourceList が再度呼び出されるまで、現在のプロセスからアクセスできる唯一のリストになります。

重要な一時リストが設定されている場合、SetupAddToSourceList または SetupRemoveFromSourceList をする後続の呼び出し明示的に指定場合でも、ソースはシステムまたはユーザーリストに対して追加または削除されません。

SRCLIST_SYSTEM、SRCLIST_USER、またはSRCLIST_TEMPORARYフラグのいずれかを指定する必要があります。

SRCLIST_NOBROWSE

SetupPromptForDisk を使用場合、ユーザーはソースの追加や変更を行うことができません。このフラグは通常、SRCLIST_TEMPORARY フラグと組み合わせて使用されます。

[in] SourceList

Flags パラメーターで指定された、ソースリストとして使用する文字列の配列へのポインター。

[in] SourceCount

SourceListによって指配列内の要素の数。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、GetLastError呼び出します。

備考

手記

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupSetSourceList を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	setupapi.h
ライブラリ	Setupapi.lib
DLL	Setupapi.dll

次の方法で共有