OleUIBusyA 関数 (oledlg.h)

  • [アーティクル]

標準の [ビジー ] ダイアログ ボックスを呼び出し、ユーザーがコンカレンシーを管理できるようにします。

構文

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

パラメーター

[in] unnamedParam1

ダイアログ ボックスの初期化に使用される情報を含む OLEUIBUSY 構造体へのポインター。

戻り値

この関数は、次の値を返します。

標準の成功/エラー定義

リターン コード 説明
OLEUI_FALSE
 不明なエラー (未使用)。
OLEUI_SUCCESS
 OLEUI_OKと同じエラーはありません。
OLEUI_OK
 ユーザーが [OK] ボタンを押しました。
OLEUI_CANCEL
 ユーザーが [キャンセル ] ボタンを押し、呼び出し元が操作を取り消す必要がある。
OLEUI_BZ_SWITCHTOSELECTED
 ユーザーが [切り替え] を 押し、 OleUIBusy がブロックしているアプリケーションに切り替える方法を判断できませんでした。 この場合、呼び出し元は、可能であれば競合自体の解決を試みるために対策を講じるか、操作を再試行する必要があります。 OleUIBusy は、ユーザーが [切り替え ] ボタンを押し、 hTask が NULL で、BZ_NOTRESPONDING フラグが設定されている場合にのみ、OLEUI_BZ_SWITCHTOSELECTEDを返します。
OLEUI_BZ_SWITCHTOSELECTED
 ユーザーが [切り替え] を 押し、 OleUIBusy がブロックしているアプリケーションに切り替える方法を判断できませんでした。 この場合、呼び出し元は、可能であれば競合自体の解決を試みるために対策を講じるか、操作を再試行する必要があります。 OleUIBusy は、ユーザーが [切り替え ] ボタンを押し、 hTask が NULL で、BZ_NOTRESPONDING フラグが設定されている場合にのみ、OLEUI_BZ_SWITCHTOSELECTEDを返します。
OLEUI_BZ_SWITCHTOSELECTED
 ユーザーが [切り替え] を 押し、 OleUIBusy がブロックしているアプリケーションに切り替える方法を判断できませんでした。 この場合、呼び出し元は、可能であれば競合自体の解決を試みるために対策を講じるか、操作を再試行する必要があります。 OleUIBusy は、ユーザーが [切り替え ] ボタンを押し、 hTask が NULL で、BZ_NOTRESPONDING フラグが設定されている場合にのみ、OLEUI_BZ_SWITCHTOSELECTEDを返します。
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 Busy]\(OLE サーバー ビジー \) ダイアログ ボックスは、サーバー アプリケーションがメッセージを受信しないことをユーザーに通知します。 その後、ダイアログ ボックスは、操作の取り消し、ブロックされているタスクへの切り替え、または待機の続行をユーザーに求めます。

注意

oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUIBUSY を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー oledlg.h
Library OleDlg.lib
[DLL] OleDlg.dll

こちらもご覧ください

OLEUIBUSY