SetupGetInfPublishedNameW 함수(setupapi.h)
통사론
WINSETUPAPI BOOL SetupGetInfPublishedNameW(
[in] PCWSTR DriverStoreLocation,
[out] PWSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[out, optional] PDWORD RequiredSize
);
매개 변수
[in] DriverStoreLocation
드라이버 저장소에 있는 INF 파일의 정규화된 파일 이름(디렉터리 경로 및 파일 이름)이 포함된 NULL로 끝나는 문자열에 대한 포인터입니다. 또는 이 매개 변수는 시스템 INF 파일 디렉터리에 있는 INF 파일의 이름 및 선택적으로 전체 디렉터리 경로를 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다. INF 파일을 지정하는 방법에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.
[out] ReturnBuffer
SetupGetInfPublishedName 시스템 INF 디렉터리에 지정된 INF 파일의 정규화된 파일 이름을 포함하는 NULL로 끝나는 문자열을 반환하는 버퍼에 대한 포인터입니다. 최대 경로 크기는 MAX_PATH. 이 포인터는 NULL
[in] ReturnBufferSize
ReturnBuffer에서 제공하는 버퍼의 크기(문자).
[out, optional] RequiredSize
ReturnBuffer 버퍼의 크기를 문자 단위로 받는 DWORD 형식 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL
반환 값
null 종결자를 포함하여 요청된 INF 파일의 정규화된 파일 이름 크기가 ReturnBufferSize보다 크면 함수가 실패하고 GetLastError 호출하면 ERROR_INSUFFICIENT_BUFFER 반환됩니다.
발언
시스템 INF 디렉터리에 지정된 INF 파일의 정규화된 파일 이름을 포함하는 데 필요한 반환 버퍼의 크기를 확인하려면 setupGetInfPublishedName
디바이스 설치 시 드라이버 저장소에 드라이버 패키지 미리 설치하면 드라이버 패키지 INF 파일의 복사본이 두 개 만들어집니다. 디바이스 설치는 시스템 INF 디렉터리에 하나의 복사본을 추가하고 INF 파일의 복사본에 OEMnnn.inf
SetupGetInfPublishedNameDriverStoreLocation제공된 INF 파일과 일치하는 시스템 INF 파일 디렉터리에 있는 INF 파일의 정규화된 파일 이름을 반환합니다.
DriverStoreLocation 드라이버 저장소에서 INF 파일의 정규화된 파일 이름을 지정하거나 시스템 INF 디렉터리에 있는 INF 파일의 파일 이름 및 선택적으로 디렉터리 경로를 지정해야 합니다. 예를 들어 드라이버 패키지의 INF 파일이 myinf.inf
SetupGetInfDriverStoreLocation 함수를 호출하여 드라이버 저장소에서 시스템 INF 파일 디렉터리의 지정된 INF 파일 또는 드라이버 저장소의 지정된 파일에 해당하는 INF 파일의 정규화된 파일 이름을 검색합니다.
메모
setupapi.h 헤더는 SETUPGetInfPublishedName을 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows에서 사용할 수 있습니다. |
대상 플랫폼 | 바탕 화면 |
헤더 | setupapi.h(Setupapi.h 포함) |
라이브러리 | Setupapi.lib |