다음을 통해 공유

OleUIChangeIconA 함수(oledlg.h)

  • 아티클

사용자가 아이콘 파일, 실행 파일 또는 DLL에서 아이콘을 선택할 수 있는 표준 변경 아이콘 대화 상자를 호출합니다.

구문

UINT OleUIChangeIconA(
  [in] LPOLEUICHANGEICONA unnamedParam1
);

매개 변수

[in] unnamedParam1

이 대화 상자의 IN/Out OLEUICHANGEICON 구조체에 대한 포인터입니다.

반환 값

표준 성공/오류 정의

반환 코드 설명
OLEUI_FALSE
 알 수 없는 오류(사용되지 않음).
OLEUI_OK
 사용자가 확인 단추를 눌렀습니다.
OLEUI_SUCCESS
 OLEUI_OK 것과 같은 오류는 없습니다.
OLEUI_CANCEL
 사용자가 취소 단추를 눌렀습니다.
 

표준 필드 유효성 검사 오류

반환 코드 설명
OLEUI_ERR_STANDARDMIN
 모든 대화 상자에 공통적인 오류는 OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN 범위에 있습니다. 이 값을 사용하면 애플리케이션에서 사용자에게 오류 메시지를 표시하기 위해 표준 메시지를 테스트할 수 있습니다.
OLEUI_ERR_STRUCTURENULL
 함수에 전달된 OLEUIXXX 구조체에 대한 포인터는 NULL입니다.
OLEUI_ERR_STRUCTUREINVALID
 OLEUIXXX 구조체에 대한 읽기 또는 쓰기 액세스 권한이 부족합니다.
OLEUI_ERR_CBSTRUCTINCORRECT
 cbstruct 값이 잘못되었습니다.
OLEUI_ERR_HWNDOWNERINVALID
 hWndOwner 값이 잘못되었습니다.
OLEUI_ERR_LPSZCAPTIONINVALID
 lpszCaption 값이 잘못되었습니다.
OLEUI_ERR_LPFNHOOKINVALID
 lpfnHook 값이 잘못되었습니다.
OLEUI_ERR_HINSTANCEINVALID
 hInstance 값이 잘못되었습니다.
OLEUI_ERR_LPSZTEMPLATEINVALID
 lpszTemplate 값이 잘못되었습니다.
OLEUI_ERR_HRESOURCEINVALID
 hResource 값이 잘못되었습니다.
 

초기화 오류

반환 코드 설명
OLEUI_ERR_FINDTEMPLATEFAILURE
 대화 상자 템플릿을 찾을 수 없습니다.
OLEUI_ERR_LOADTEMPLATEFAILURE
 대화 상자 템플릿을 로드할 수 없습니다.
OLEUI_ERR_DIALOGFAILURE
 대화 상자 초기화에 실패했습니다.
OLEUI_ERR_LOCALMEMALLOC
 LocalAlloc 또는 표준 IMalloc 할당자에 대한 호출이 실패했습니다.
OLEUI_ERR_GLOBALMEMALLOC
 GlobalAlloc 또는 표준 IMalloc 할당자에 대한 호출이 실패했습니다.
OLEUI_ERR_LOADSTRING
 라이브러리에서 지역화된 리소스에 대해 LoadString을 호출할 수 없습니다.
OLEUI_ERR_OLEMEMALLOC
 표준 IMalloc 할당자에 대한 호출이 실패했습니다.
 

함수별 오류

반환 코드 설명
OLEUI_ERR_STANDARDMAX
 모든 대화 상자에 공통적인 오류는 OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN 범위에 있습니다. 이 값을 사용하면 애플리케이션에서 사용자에게 오류 메시지를 표시하기 위해 표준 메시지를 테스트할 수 있습니다.
OLEUI_CIERR_MUSTHAVECLSID
 clsid 멤버가 현재 CLSID가 아닙니다.
OLEUI_CIERR_MUSTHAVECURRENTMETAFILE
 hMetaPict 멤버가 현재 메타파일이 아닙니다.
OLEUI_CIERR_SZICONEXEINVALID
 szIconExe 값이 잘못되었습니다.

설명

OLEUICHANGEICON 구조체.

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 oledlg.h
라이브러리 OleDlg.lib
DLL OleDlg.dll

추가 정보

OLEUICHANGEICON