SetupSetSourceListW 関数 (setupapi.h)

[アーティクル]
08/26/2023

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

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

構文

WINSETUPAPI BOOL SetupSetSourceListW(
  [in] DWORD  Flags,
  [in] PCWSTR *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 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	setupapi.h
Library	Setupapi.lib
[DLL]	Setupapi.dll