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 헤더는 SETUPDiGetActualSectionToInstallEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows XP 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	바탕 화면
헤더	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib

참고 항목

INF DDInstall 섹션

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice

다음을 통해 공유