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를 호출합니다.

설명

요구 사항

참조

함수

개요

SetupQueryDrivesInDiskSpaceList