SetupDiGetActualSectionToInstallExW 함수(setupapi.h)
SetupDiGetActualSectionToInstallEx 함수는 지정된 운영 체제 및 프로세서 아키텍처에 대한 디바이스를 설치하는 INF DDInstall 섹션의 이름을 검색합니다.
구문
WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExW(
[in] HINF InfHandle,
[in] PCWSTR InfSectionName,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PWSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
[out, optional] PWSTR *Extension,
PVOID Reserved
);
매개 변수
[in] InfHandle
DDInstall 섹션이 포함된 INF 파일에 대한 핸들입니다.
[in] InfSectionName
DDInstall 섹션 이름에 대한 포인터입니다(INF 모델 섹션에 지정된 대로). 섹션 이름의 최대 길이(문자)는 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 |