다음을 통해 공유

OleUIPromptUserA 함수(oledlg.h)

  • 아티클

지정된 템플릿이 있는 대화 상자를 표시하고 사용자의 응답(단추 식별자)을 반환합니다. 이 함수는 OLE 경고 메시지(예: 등록되지 않은 클래스)를 표시하는 데 사용됩니다.

통사론

int OleUIPromptUserA(
  [in] int  nTemplate,
  [in] HWND hwndParent,
       ...  
);

매개 변수

[in] nTemplate

표시할 대화 상자의 리소스 번호입니다. 비고를 참조하세요.

[in] hwndParent

대화 상자의 부모 창에 대한 핸들입니다.

...

선택적. 대화 상자의 제목 뒤에 대화 상자의 정적 컨트롤(IDC_PU_TEXT)에 있는 형식 문자열에 대한 인수 목록이 표시됩니다. 호출자는 올바른 수와 형식의 인수를 전달해야 합니다.

반환 값

표준 성공/오류 정의

반환 코드 묘사
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 범위에 있습니다. 이 값을 사용하면 애플리케이션에서 사용자에게 오류 메시지를 표시하기 위해 표준 메시지를 테스트할 수 있습니다.

발언

다음 대화 상자 템플릿은 소프트웨어 디자인 가이드인 Windows 인터페이스 지침에 정의되어 있습니다. nTemplate 매개 변수는 현재 정의된 리소스여야 하지만 prompt.dlg에 추가 템플릿을 추가할 수 있습니다.

IDD_LINKSOURCEUNAVAILABLE 
IDD_CANNOTUPDATELINK 
IDD_SERVERNOTREG 
IDD_CANNOTRESPONDVERB 
IDD_SERVERNOTFOUND

메모

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

요구 사항

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