DlgDirSelectExA 함수(winuser.h)

아티클
03/13/2024

단일 선택 목록 상자에서 현재 선택 영역을 검색합니다. 목록 상자가 DlgDirList 함수에 의해 채워졌으며 선택 영역이 드라이브 문자, 파일 이름 또는 디렉터리 이름이라고 가정합니다.

구문

BOOL DlgDirSelectExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   chCount,
  [in]  int   idListBox
);

매개 변수

[in] hwndDlg

형식: HWND

목록 상자가 포함된 대화 상자에 대한 핸들입니다.

[out] lpString

형식: LPTSTR

선택한 경로를 수신하는 버퍼에 대한 포인터입니다.

[in] chCount

형식: int

lpString이 가리키는 버퍼의 길이(TCHAR)입니다.

[in] idListBox

형식: int

대화 상자의 목록 상자 식별자입니다.

반환 값

형식: BOOL

현재 선택 영역이 디렉터리 이름인 경우 반환 값은 0이 아닌 값입니다.

현재 선택 영역이 디렉터리 이름이 아닌 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

DlgDirSelectEx 함수는 lpString 매개 변수가 가리키는 버퍼에 선택 영역을 복사합니다. 현재 선택 영역이 디렉터리 이름 또는 드라이브 문자인 경우 DlgDirSelectEx 는 바깥쪽 대괄호(드라이브 문자의 경우 하이픈)를 제거하여 이름이나 문자를 새 경로에 삽입할 준비가 됩니다. 선택 항목이 없으면 lpString이 변경되지 않습니다.

문자열이 버퍼보다 길거나 긴 경우 버퍼에는 null 문자가 끝나는 잘린 문자열이 포함됩니다.

DlgDirSelectEx 는 LB_GETCURSEL 및 LB_GETTEXT 메시지를 목록 상자로 보냅니다. 함수는 목록 상자에서 둘 이상의 파일 이름을 반환할 수 없습니다. 목록 상자는 다중 선택 목록 상자가 아니어야 합니다. 이 경우 이 함수는 0 값을 반환하지 않으며 lpString 은 변경되지 않은 상태로 유지됩니다.

Windows 95 이상: DlgDirSelectExW 는 Microsoft Layer for Unicode에서 지원됩니다. 이를 사용하려면 Windows Me/98/95 시스템의 Microsoft Layer for Unicode에 설명된 대로 특정 파일을 애플리케이션에 추가해야 합니다.

예제

예를 들어 단일 선택 목록 상자에서 디렉터리 목록 만들기를 참조하세요.

참고

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

요구 사항

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