다음을 통해 공유

OleUIConvertA 함수(oledlg.h)

  • 아티클

사용자가 지정된 단일 개체의 형식 또는 지정된 개체 클래스의 모든 OLE 개체 형식을 변경할 수 있도록 표준 변환 대화 상자를 호출합니다.

구문

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

매개 변수

[in] unnamedParam1

대화 상자를 초기화하는 데 사용되는 정보를 포함하는 OLEUICONVERT 구조체에 대한 포인터입니다.

반환 값

표준 성공/오류 정의

반환 코드 설명
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_CTERR_CLASSIDINVALID
 clsid 값이 잘못되었습니다.
OLEUI_CTERR_DVASPECTINVALID
 dvAspect 값이 잘못되었습니다. 이 멤버는 개체의 측면을 지정합니다.
OLEUI_CTERR_CBFORMATINVALID
 wFormat 값이 잘못되었습니다. 이 멤버는 개체의 데이터 형식을 지정합니다.
OLEUI_CTERR_STRINGINVALID
 문자열 값(예: lpszUserType 또는 lpszDefLabel)이 잘못되었습니다.

설명

OleUIConvert 는 레지스트리를 트래버스하고 읽기 가능 및 읽기 가능 키에서 항목을 찾아 서 변환 대화 상자의 목록 상자를 개체 클래스로 채웁니다. 읽기 가능한 키에 원래 클래스의 기본 파일 형식을 포함하는 모든 클래스가 변환 목록에 추가되고, ReadWritable 키에 원래 클래스의 기본 파일 형식을 포함하는 모든 클래스가 다른 항목 활성화 목록에 추가됩니다. 변환 목록은 변환 라디오 단추(기본 선택 영역)를 선택하면 대화 상자의 목록 상자에 표시되고 다른 이름으로 활성화를 선택하면 다른 이름으로 활성화 목록이 표시됩니다.

CF_CONVERTONLY 지정되지 않은 경우에만 지정된 클래스의 모든 개체 형식을 변경할 수 있습니다.

이 함수를 호출하는 convert 명령은 OleUICanConvertOrActivateAs 가 S_OK 반환하는 경우에만 사용자에게 제공되어야 합니다.

참고

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

요구 사항

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

추가 정보

OLEUICONVERT

OleUICanConvertOrActivateAs