DlgDirSelectComboBoxExA 함수(winuser.h)

DlgDirListComboBox 함수를 사용하여 채워진 콤보 상자에서 현재 선택 항목을 검색합니다. 선택 항목은 드라이브 문자, 파일 또는 디렉터리 이름으로 해석됩니다.

구문

BOOL DlgDirSelectComboBoxExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   cchOut,
  [in]  int   idComboBox
);

매개 변수

[in] hwndDlg

형식: HWND

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

[out] lpString

형식: LPTSTR

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

[in] cchOut

형식: int

lpString 매개 변수가 가리키는 버퍼의 길이(문자)입니다.

[in] idComboBox

형식: int

대화 상자에 있는 콤보 상자 컨트롤의 정수 식별자입니다.

반환 값

형식: BOOL

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

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

설명

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

DlgDirSelectComboBoxEx 함수는 콤보 상자에서 둘 이상의 파일 이름을 반환할 수 없습니다.

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

DlgDirSelectComboBoxEx 는 CB_GETCURSEL 및 CB_GETLBTEXT 메시지를 콤보 상자로 보냅니다.

이 함수는 세 가지 유형의 콤보 상자(CBS_SIMPLE, CBS_DROPDOWN 및 CBS_DROPDOWNLIST)와 함께 사용할 수 있습니다.

보안 경고: 이 함수를 잘못 사용하면 애플리케이션에 문제가 발생할 수 있습니다. instance 경우 ANSI 및 유니코드 버전 모두에 대해 nCount 매개 변수를 올바르게 설정해야 합니다. 이렇게 하지 않으면 버퍼 오버플로가 발생할 수 있습니다. 계속하기 전에 보안 고려 사항: Microsoft Windows 컨트롤을 검토해야 합니다.

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

참고

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

요구 사항

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

추가 정보

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

참조