PickIconDlg 함수(shlobj_core.h)

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

사용자가 실행 파일 또는 DLL 파일과 같은 리소스에 포함된 선택 영역에서 아이콘을 선택할 수 있는 대화 상자를 표시합니다.

구문

int PickIconDlg(
  [in, optional]      HWND  hwnd,
  [in, out]           PWSTR pszIconPath,
                      UINT  cchIconPath,
  [in, out, optional] int   *piIconIndex
);

매개 변수

[in, optional] hwnd

형식: HWND

부모 창의 핸들입니다. 이 값은 NULL일 수 있습니다.

[in, out] pszIconPath

형식: PWSTR

아이콘을 포함하는 기본 리소스의 null로 끝나는 정규화된 경로를 포함하는 문자열에 대한 포인터입니다. 사용자가 대화 상자에서 다른 리소스를 선택하는 경우 함수가 반환되면 이 버퍼에 해당 파일의 경로가 포함됩니다. 이 버퍼의 길이는 MAX_PATH 이상이어야 합니다. 그렇지 않으면 반환된 경로가 잘리게 될 수 있습니다. 경로를 사용하기 전에 경로가 유효한지 확인해야 합니다.

cchIconPath

형식: UINT

종료되는 NULL 문자를 포함하여 pszIconPath의 문자 수입니다.

[in, out, optional] piIconIndex

형식: int*

항목에서 초기 선택 영역의 인덱스를 지정하는 정수에 대한 포인터이며, 이 함수가 성공적으로 반환되면 선택한 아이콘의 인덱스를 받습니다.

반환 값

형식: int

성공하면 1을 반환합니다. 그렇지 않으면 0입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.0 이상)
API 세트	ext-ms-win-shell-shell32-l1-2-1(Windows 10 버전 10.0.10240에 도입됨)