다음을 통해 공유

OleUIBusyW 함수(oledlg.h)

  • 아티클

표준 사용 중인 대화 상자를 호출하여 사용자가 동시성을 관리할 수 있도록 합니다.

통사론

UINT OleUIBusyW(
  [in] LPOLEUIBUSYW unnamedParam1
);

매개 변수

[in] unnamedParam1

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

반환 값

이 함수는 다음 값을 반환합니다.

표준 성공/오류 정의

반환 코드 묘사
OLEUI_FALSE
 알 수 없는 오류(사용되지 않음)
OLEUI_SUCCESS
 OLEUI_OK 것과 같은 오류가 없습니다.
OLEUI_OK
 사용자가 확인 단추를 눌렀습니다.
OLEUI_CANCEL
 사용자가 취소 단추를 누르고 호출자가 작업을 취소해야 합니다.
OLEUI_BZ_SWITCHTOSELECTED
 사용자가 스위치를 누른 OleUIBusy 차단 애플리케이션으로 전환하는 방법을 확인할 수 없습니다. 이 경우 호출자는 가능한 경우 충돌 자체를 해결하기 위한 조치를 취하거나 작업을 다시 시도해야 합니다. OleUIBusy 사용자가 스위치 단추를 누른 경우에만 OLEUI_BZ_SWITCHTOSELECTED 반환합니다. hTask NULL BZ_NOTRESPONDING 플래그가 설정됩니다.
OLEUI_BZ_SWITCHTOSELECTED
 사용자가 스위치를 누른 OleUIBusy 차단 애플리케이션으로 전환하는 방법을 확인할 수 없습니다. 이 경우 호출자는 가능한 경우 충돌 자체를 해결하기 위한 조치를 취하거나 작업을 다시 시도해야 합니다. OleUIBusy 사용자가 스위치 단추를 누른 경우에만 OLEUI_BZ_SWITCHTOSELECTED 반환합니다. hTask NULL BZ_NOTRESPONDING 플래그가 설정됩니다.
OLEUI_BZ_SWITCHTOSELECTED
 사용자가 스위치를 누른 OleUIBusy 차단 애플리케이션으로 전환하는 방법을 확인할 수 없습니다. 이 경우 호출자는 가능한 경우 충돌 자체를 해결하기 위한 조치를 취하거나 작업을 다시 시도해야 합니다. OleUIBusy 사용자가 스위치 단추를 누른 경우에만 OLEUI_BZ_SWITCHTOSELECTED 반환합니다. hTask NULL BZ_NOTRESPONDING 플래그가 설정됩니다.
OLEUI_BZ_RETRYSELECTED
사용자가 다시 시도 단추를 누르거나 충돌을 해결하려고 했습니다(차단 애플리케이션으로 전환). 이 경우 호출자는 작업을 다시 시도해야 합니다.
OLEUI_BZ_CALLUNBLOCKED
작업이 더 이상 차단되지 않는다는 대화 상자가 표시됩니다.
 

표준 필드 유효성 검사 오류

반환 코드 묘사
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_BZERR_HTASKINVALID
 OLEUIBUSY 구조체의 hTask 멤버에 지정된 hTask가 잘못되었습니다.

발언

표준 OLE Server 사용 중인 대화 상자는 서버 애플리케이션이 메시지를 받지 못하고 있음을 사용자에게 알깁니다. 그런 다음, 대화 상자에서 사용자에게 작업을 취소하거나, 차단된 작업으로 전환하거나, 대기를 계속하도록 요청합니다.

메모

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

요구 사항

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

참고 항목

OLEUIBUSY