SetupDiGetActualSectionToInstallExA 関数 (setupapi.h)

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

SetupDiGetActualSectionToInstallEx 関数は、指定したオペレーティングシステムとプロセッサアーキテクチャのデバイスをインストールする INF DDInstall セクションの名前を取得します。

構文

WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExA(
  [in]            HINF                 InfHandle,
  [in]            PCSTR                InfSectionName,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
  [out, optional] PSTR                 *Extension,
                  PVOID                Reserved
);

パラメーター

[in] InfHandle

DDInstall セクションを含む INF ファイルへのハンドル。

[in] InfSectionName

DDInstall セクション名へのポインター (INF Models セクションで指定)。セクション名の最大長 (文字数) は 254 です。

[in, optional] AlternatePlatformInfo

null以外の場合は、SP_ALTPLATFORM_INFO 構造体へのポインター。この構造体は、ローカルコンピューター上とは異なるオペレーティングシステムとプロセッサアーキテクチャを指定するために使用されます。ローカルコンピューターの DDInstall セクション名を取得するには、このパラメーターを null設定します。それ以外の場合は、SP_ALTPLATFORM構造体を指定し、そのメンバーを次のように設定します。

cbSize

SP_ALTPLATFORM_INFO構造体のサイズ (バイト単位) に設定します。

プラットホーム

Windows XP 以降のバージョンの Windows のVER_PLATFORM_WIN32_NTに設定します。

MajorVersion

使用されません。

MinorVersion

使用されません。

ProcessorArchitecture

次のプロセッサアーキテクチャ定数のいずれかを設定します。

プロセッサアーキテクチャ定数	意味
PROCESSOR_ARCHITECTURE_INTEL	代替プラットフォームは、x86 ベースのプロセッサアーキテクチャです。
PROCESSOR_ARCHITECTURE_IA64	代替プラットフォームは、Itanium ベースのプロセッサアーキテクチャです。
PROCESSOR_ARCHITECTURE_AMD64	代替プラットフォームは、x64 ベースのプロセッサアーキテクチャです。

引っ込み思案

0 に設定します。

[out, optional] InfSectionWithExt

DDInstall セクション名、そのプラットフォーム拡張機能、および NULL ターミネータを受け取る文字バッファーへのポインター。これは、インストールに使用する必要がある装飾セクション名です。このパラメーターが NULL場合、関数は TRUE 返し、requiredSize を、DDInstall セクション名、そのプラットフォーム拡張機能、および終了 NULL 文字を返すために必要なサイズ (文字数) に設定します。

[in] InfSectionWithExtSize

InfSectionWithExt パラメーターが指すバッファーのサイズ (文字数)。 NULL で終わる INF セクション名の最大長 (文字数) はMAX_INF_SECTION_NAME_LENGTH。

[out, optional] RequiredSize

DDInstall セクション名、プラットフォーム拡張機能、および終了 NULL 文字を返すために必要なサイズを文字で受け取る変数へのポインター。

[out, optional] Extension

InfSectionWithExt バッファー内の拡張機能の先頭をマークする '.' 文字へのポインターを受け取る変数へのポインター。 InfSectionWithExt バッファーが指定されていないか、小さすぎる場合、このパラメーターは設定されません。拡張機能へのポインターが必要ない場合は、このパラメーターを NULL をに設定します。

Reserved

内部使用専用に予約されています。 NULLをに設定する必要があります。

戻り値

関数が成功した場合は、TRUE返します。それ以外の場合は、FALSE返します。拡張エラー情報を取得するには、GetLastError呼び出します。

備考

SetupDiGetActualSectionToInstallEx は、SetupDiGetActualSectionToInstallの拡張形式です。これらの関数は、デバイスの OS 固有およびアーキテクチャ固有のインストールアクションを指定するために使用される DDInstall セクション名をする拡張機能をサポートします。これらの拡張機能の詳細については、「複数のプラットフォームおよびオペレーティングシステム用の INF ファイルの作成」を参照してください。

SetupDiGetActualSectionToInstallEx呼び出しで代替プラットフォーム情報を指定しない場合、この関数は SetupDiGetActualSectionToInstallと同じ操作を実行します。後者の関数は、ローカルコンピューターのプラットフォーム情報を使用して、指定されたインストールセクション名を検索します。

SetupDiGetActualSectionToInstallEx呼び出しで代替プラットフォーム情報を指定すると、関数は次の処理を実行します。

VER_PLATFORM_WIN32_NTのプラットフォームを指定した場合、関数は最初に、指定した INF ファイル内で、指定した名前、オペレーティングシステム、およびプロセッサアーキテクチャと一致する装飾済みインストールセクション名を検索します。たとえば、InstallSecのインストールセクション名
指定した場合、関数は、指定されたプロセッサアーキテクチャに応じて、次のいずれかの修飾名を検索します。
- x86 ベースのプロセッサアーキテクチャを指定すると、InstallSec.ntx86修飾名が検索されます。
- x64 ベースのプロセッサアーキテクチャを指定すると、InstallSec.ntamd64修飾名が検索されます。
- Itanium ベースのプロセッサアーキテクチャを指定すると、InstallSec.ntia64修飾名が検索されます。
関数は、名前、オペレーティングシステム、およびプロセッサアーキテクチャの一致を検出すると、検索を終了し、対応する修飾名を返します。関数がそのような一致を見つけられない場合、関数は InstallSec.nt名前のセクションを検索します。 InstallSec.ntの一致検出された場合、関数は検索を終了し、この名前を返します。関数は、上記の検索のいずれかに一致するものが見つからない場合、InstallSec返しますが、名前が InstallSecインストールセクションが INF ファイルに含まれていることは確認しません。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows XP 以降のバージョンの Windows で使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	setupapi.h (Setupapi.h を含む)
ライブラリ	Setupapi.lib

次の方法で共有