SetupSetPlatformPathOverrideA 関数 (setupapi.h)
[この機能は、[要件] セクションに示されているオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、Windows インストーラーを使用してアプリケーション インストーラーを開発します。 SetupAPI は、引き続きデバイス ドライバーのインストールに使用されます。
SetupSetPlatformPathOverride 関数は、別のコンピューターの INF を操作するときに、ターゲット コンピューターのプラットフォーム パスのオーバーライドを設定するために使用されます。 そのため、現在実行されているプラットフォームとは異なるプラットフォームを参照できます。 メディア ソースを扱う場合は、Alpha、MIPS、PPC など、サポートされなくなったプラットフォームを参照できます。 何も指定されていない場合は、プラットフォーム パスのオーバーライドが削除されます。
構文
WINSETUPAPI BOOL SetupSetPlatformPathOverrideA(
[in] PCSTR Override
);
パラメーター
[in] Override
置換プラットフォーム情報を含む null で終わる文字列へのポインター。 たとえば、"alpha" や "x86" などです。 このパラメーターは NULL である可能性があります。
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
GetLastError がERROR_NOT_ENOUGH_MEMORYを返す場合、SetupSetPlatformPathOverride はオーバーライド文字列を格納できませんでした。
注釈
SetPlatformPathOverride は、ファイルをキューに入れたときにソース パスを変更するために使用されます。 SetPlatformPathOverride の呼び出しによってプラットフォーム パスのオーバーライドが設定されている場合、ファイル コピー操作をキューに入れたセットアップ関数はソース パスの最終的なコンポーネントを調べ、最終的なコンポーネントがユーザーのプラットフォームの名前と一致する場合は、SetPlatformPathOverride によって設定されたオーバーライド文字列に置き換えます。
たとえば、 SetPlatformPathOverride の呼び出しによってプラットフォームが Alpha に設定されている MIPS プラットフォーム マシンを考えてみましょう。 プラットフォーム パスのオーバーライドが設定されると、ファイル コピー操作が \pop\top\baz\mips\x.exe のソース パスを使用してキューに入れられます。パスは \pop\top\baz\alpha\x.exe に変更されます。
パスのオーバーライドが設定される前にキューに入っているファイル コピー操作のパスは変更されません。
注意
setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupSetPlatformPathOverride を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | setupapi.h |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |