次の方法で共有

OleUIConvertA 関数 (oledlg.h)

  • [アーティクル]

標準 変換 ダイアログ ボックスを呼び出し、指定した 1 つのオブジェクトの型、または指定したオブジェクトのクラスのすべての OLE オブジェクトの型をユーザーが変更できるようにします。

構文

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

パラメーター

[in] unnamedParam1

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

戻り値

標準の成功/エラー定義

リターン コード 形容
OLEUI_FALSE
 不明なエラー (未使用)。
OLEUI_OK
 ユーザーが [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 キーに含まれるすべてのクラスが Activate As リストに追加されます。 [変換] ボックスの一覧は、[変換] オプション ボタン (既定の選択) が選択されている場合はダイアログ ボックスのリスト ボックスに表示され、[ としてアクティブ化] が選択されている場合は [アクティブ化] リストが表示されます。

特定のクラスのすべてのオブジェクトの型は、CF_CONVERTONLYが指定されていない場合にのみ変更できることに注意してください。

この関数を呼び出す convert コマンドは、OleUICanConvertOrActivateAs がS_OKを返す場合にのみ、ユーザーが使用できるようにする必要があります。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー oledlg.h
ライブラリ OleDlg.lib
DLL OleDlg.dll

関連項目

OLEUICONVERT を する

OleUICanConvertOrActivateAs