SetupFindNextMatchLineA 関数 (setupapi.h)
[この機能は、[要件] セクションに示されているオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、Windows インストーラーを使用してアプリケーション インストーラーを開発します。 SetupAPI は、引き続きデバイス ドライバーのインストールに使用されます。
SetupFindNextMatchLine 関数は、指定したキーと一致する ContextIn.Line に対する INF ファイル内の次の行の位置を返します。
構文
WINSETUPAPI BOOL SetupFindNextMatchLineA(
[in] PINFCONTEXT ContextIn,
[in] PCSTR Key,
[in, out] PINFCONTEXT ContextOut
);
パラメーター
[in] ContextIn
SetupFindFirstLine 関数の呼び出しによって取得される INF ファイル コンテキストへのポインター。
[in] Key
この省略可能なパラメーターを指定すると、一致するキーが提供されます。 このパラメーターは、null で終わる文字列である必要があります。 このパラメーターには Null を指定できます。 Key が指定されていない場合、SetupFindNextMatchLine 関数は SetupFindNextLine 関数と同じです。
[in, out] ContextOut
この関数が見つかった行のコンテキストを返す変数へのポインター。 呼 び出し元が望む場合、 ContextOut は ContextIn を指すことができます。
戻り値
関数は、一致する行が見つかると 0 以外の値を返します。 それ以外の場合、戻り値は 0 です。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
ContextIn.Inf が SetupOpenAppendInfFile を使用して追加された複数の INF ファイルを参照している場合、SetupFindNextMatchLine 関数は HINF によって参照されるすべてのファイル内の指定されたセクション全体を検索して、次に一致する行を検索します。
注意
setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupFindNextMatchLine を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | setupapi.h |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |
| API セット | ext-ms-win-setupapi-inf-l1-1-0 (Windows 8 で導入) |