SHFormatDrive 함수(shlobj_core.h)

[SHFormatDrive 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

셸의 서식 대화 상자를 엽니다.

구문

DWORD SHFormatDrive(
  [in] HWND hwnd,
       UINT drive,
       UINT fmtID,
       UINT options
);

매개 변수

[in] hwnd

형식: HWND

대화 상자의 부모 창 핸들입니다. 서식 대화 상자에는 부모 창이 있어야 합니다. 따라서 이 매개 변수는 NULL일 수 없습니다.

drive

형식: UINT

형식을 지정할 드라이브입니다. 이 매개 변수의 값은 A: 드라이브에 대해 0부터 시작하는 문자 드라이브를 나타냅니다. 예를 들어 값 2는 C: 드라이브를 의미합니다.

fmtID

형식: UINT

실제 형식의 ID입니다. 현재 다음 플래그만 정의되어 있습니다.

SHFMT_ID_DEFAULT(0xFFFF)

기본 형식 ID입니다.

options

형식: UINT

이 값은 0이거나 대화 상자의 기본 형식 옵션을 변경하는 다음 값 중 하나여야 합니다. 이 값은 비트 필드로 간주되며 그에 따라 처리되어야 합니다.

SHFMT_OPT_FULL(0x0001)

0x001. 이 플래그를 설정하면 빠른 형식 옵션이 선택됩니다.

이 함수는 Sp1 이상이 있는 Windows XP에서만 Shlobj.h에 포함됩니다.

Windows XP: SP1이 있는 Windows XP 이전에는 Shell32.lib를 통해 이 함수에 액세스할 수 있습니다.

SHFMT_OPT_SYSONLY(0x0002)

0x002. MS-DOS 시작 디스크 만들기 옵션을 선택하여 시스템 부팅 디스크를 만듭니다.

반환 값

형식:DWORD

마지막으로 성공한 형식의 형식 ID 또는 다음 값 중 하나를 반환합니다. 이 값의 LOWORD는 fmtID 매개 변수로 후속 호출에 전달되어 마지막 형식을 반복할 수 있습니다.

반환 코드	설명
SHFMT_ERROR	마지막 형식 중에 오류가 발생했습니다. 이는 드라이브의 형식을 지정할 수 없음을 나타내지 않습니다.
SHFMT_CANCEL	마지막 형식이 취소되었습니다.
SHFMT_NOFORMAT	드라이브의 형식을 지정할 수 없습니다.

설명

형식은 대화 상자 인터페이스에 의해 제어됩니다. 즉, 사용자가 확인 단추를 클릭하여 실제로 형식을 시작해야 합니다. 형식은 프로그래밍 방식으로 시작할 수 없습니다.

예제

SHFormatDrive를 호출하면 A 드라이브의 디스크에 대한 셸의 형식 대화 상자가 표시되고 기본 서식 옵션이 선택됩니다.

SHFormatDrive(hMainWnd, 0, SHFMT_ID_DEFAULT, 0);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)