SetupFindNextMatchLineA 함수(setupapi.h)

아티클
03/05/2024

[이 함수는 요구 사항 섹션에 표시된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. SetupAPI는 더 이상 애플리케이션 설치에 사용되지 않아야 합니다. 대신 Windows Installer를 사용하여 애플리케이션 설치 관리자를 개발합니다. 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일 수 있습니다. 키를 지정하지 않으면 SetupFindNextMatchLine 함수는 SetupFindNextLine 함수와 동일합니다.

[in, out] ContextOut

이 함수가 찾은 줄의 컨텍스트를 반환하는 변수에 대한 포인터입니다. ContextOut은 호출자가 원하는 경우 ContextIn 을 가리킬 수 있습니다.

반환 값

함수는 일치하는 줄을 찾으면 0이 아닌 값을 반환합니다. 그렇지 않으면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

ContextIn.Inf가 SetupOpenAppendInfFile을 사용하여 함께 추가된 여러 INF 파일을 참조하는 경우 SetupFindNextMatchLine 함수는 HINF에서 참조하는 모든 파일에서 지정된 섹션을 검색하여 다음 일치 줄을 찾습니다.

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	setupapi.h
라이브러리	Setupapi.lib
DLL	Setupapi.dll
API 세트	ext-ms-win-setupapi-inf-l1-1-0(Windows 8 도입)