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)와 함께 사용할 수 있습니다.

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

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

메모

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

요구 사항

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

참고 항목

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

참조