SetupQuerySpaceRequiredOnDriveA 함수(setupapi.h)
[이 함수는 요구 사항 섹션에 표시된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. SetupAPI는 더 이상 애플리케이션 설치에 사용되지 않아야 합니다. 대신 Windows Installer를 사용하여 애플리케이션 설치 관리자를 개발합니다. SetupAPI는 디바이스 드라이버를 설치하는 데 계속 사용됩니다.]
SetupQuerySpaceRequiredOnDrive 함수는 디스크 공간 목록을 검사하여 특정 드라이브에 대해 나열된 모든 파일 작업을 수행하는 데 필요한 공간을 확인합니다.
구문
WINSETUPAPI BOOL SetupQuerySpaceRequiredOnDriveA(
[in] HDSKSPC DiskSpace,
[in] PCSTR DriveSpec,
[out] LONGLONG *SpaceRequired,
[in] PVOID Reserved1,
[in] UINT Reserved2
);
매개 변수
[in] DiskSpace
디스크 공간 목록에 대한 핸들입니다.
[in] DriveSpec
공간 정보를 반환할 드라이브를 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
"x:" 또는 "\server\share" 형식이어야 합니다.
[out] SpaceRequired
함수가 성공하면 이 매개 변수는 DriveSpec 이 지정하는 드라이브의 디스크 공간 목록에 나열된 모든 파일 작업을 처리하는 데 필요한 추가 공간을 받습니다.
SetupQuerySpaceRequiredOnDrive 함수는 대상 드라이브에 있는 파일의 기존 버전을 확인하여 대상 드라이브에 필요한 추가 공간을 계산합니다.
예를 들어 파일 작업에서 FIRST.EXE 2000바이트 파일을 C:\MYPROG 디렉터리에 복사하는 경우 SetupQuerySpaceRequiredOnDrive 함수는 해당 디렉터리에 있는 해당 파일의 기존 버전을 자동으로 확인합니다. 기존 버전의 C:\MYPROG\FIRST.EXE 파일 크기가 500바이트인 경우 해당 작업에 C 드라이브에 필요한 추가 공간은 1500바이트입니다.
추가 공간이 필요하지 않거나 대상 드라이브에서 공간이 해제된 경우 수신된 값은 0 또는 음수일 수 있습니다.
앞의 예제에서 FIRST.EXE C 드라이브에서 삭제되는 경우 필요한 공간의 양은 2,000바이트이거나 C 드라이브에서 해제된 공간입니다.
기존 버전의 파일 크기가 5000바이트인 경우 2000바이트 FIRST.EXE 교체하는 데 필요한 디스크 공간은 3,000바이트입니다.
파일 크기는 디스크 클러스터 경계로 반올림됩니다.
[in] Reserved1
예약; 는 0이어야 합니다.
[in] Reserved2
예약; 는 0이어야 합니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값이고 SpaceRequired 는 현재 디스크 공간 목록에 나열된 파일 작업에 필요한 공간의 양을 받습니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
반환 코드 | 설명 |
---|---|
|
지정된 드라이브가 디스크 공간 목록에 없습니다. |
|
지정된 DiskSpace 핸들이 잘못되었습니다. |
|
지정된 DriveSpec 문자열이 잘못되었습니다. |
설명
참고
setupapi.h 헤더는 SETUPQuerySpaceRequiredOnDrive를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | setupapi.h |
라이브러리 | Setupapi.lib |
DLL | Setupapi.dll |