OleUIConvertA 関数 (oledlg.h)
標準の [変換 ] ダイアログ ボックスを呼び出し、指定した 1 つのオブジェクトの型、または指定したオブジェクトのクラスのすべての OLE オブジェクトの型をユーザーが変更できるようにします。
構文
UINT OleUIConvertA(
[in] LPOLEUICONVERTA unnamedParam1
);
パラメーター
[in] unnamedParam1
ダイアログ ボックスの初期化に使用する情報を含む OLEUICONVERT 構造体へのポインター。
戻り値
標準の成功/エラー定義
| リターン コード | 説明 |
|---|---|
|
不明なエラー (未使用)。 |
|
ユーザーが [OK] ボタンを押しました。 |
|
OLEUI_OKと同じエラーはありません。 |
|
ユーザーが [キャンセル] ボタンを押しました。 |
標準フィールドの検証エラー
| リターン コード | 説明 |
|---|---|
|
すべてのダイアログ ボックスに共通するエラーは、OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN範囲内にあります。 この値を使用すると、ユーザーにエラー メッセージを表示するために、アプリケーションで標準メッセージをテストできます。 |
|
関数に渡された OLEUIXXX 構造体へのポインターが NULL でした。 |
|
OLEUIXXX 構造体への読み取りまたは書き込みアクセスに対するアクセス許可が不十分です。 |
|
cbstruct 値が正しくありません。 |
|
hWndOwner 値が無効です。 |
|
lpszCaption 値が無効です。 |
|
lpfnHook 値が無効です。 |
|
hInstance 値が無効です。 |
|
lpszTemplate 値が無効です。 |
|
hResource 値が無効です。 |
初期化エラー
| リターン コード | 説明 |
|---|---|
|
ダイアログ ボックス テンプレートが見つかりません。 |
|
ダイアログ ボックス テンプレートを読み込むことができません。 |
|
ダイアログ ボックスの初期化に失敗しました。 |
|
LocalAlloc または標準の IMalloc アロケーターの呼び出しに失敗しました。 |
|
GlobalAlloc または標準の IMalloc アロケーターの呼び出しに失敗しました。 |
|
ライブラリからローカライズされたリソースに対して LoadString を呼び出すことができません。 |
|
標準 の IMalloc アロケーターの呼び出しに失敗しました。 |
関数固有のエラー
| リターン コード | 説明 |
|---|---|
|
すべてのダイアログ ボックスに共通するエラーは、OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN範囲内にあります。 この値を使用すると、ユーザーにエラー メッセージを表示するために、アプリケーションで標準メッセージをテストできます。 |
|
clsid 値が無効です。 |
|
dvAspect 値が無効です。 このメンバーは、オブジェクトの側面を指定します。 |
|
wFormat 値が無効です。 このメンバーは、 オブジェクトのデータ形式を指定します。 |
|
文字列値 ( lpszUserType や lpszDefLabel など) が無効です。 |
注釈
OleUIConvert は、レジストリを走査し、[読み取り可能] キーと [読み取り可能] キーでエントリを探すことで、[ 変換 ] ダイアログ ボックスのリスト ボックスにオブジェクト クラスを設定します。 元のクラスの既定のファイル形式を Readable キーに含めるすべてのクラスが変換リストに追加され、元のクラスの既定のファイル形式が ReadWritable キーに含まれるすべてのクラスが Activate As リストに追加されます。 [変換] オプション ボタン (既定の選択項目) が選択されている場合、ダイアログ ボックスのリスト ボックスに [変換 ] リストが表示され、[アクティブ化] が 選択されている場合 は [アクティブ化] リストが表示されます。
特定のクラスのすべてのオブジェクトの型は、CF_CONVERTONLYが指定されていない場合にのみ変更できることに注意してください。
この関数を呼び出す convert コマンドは、 OleUICanConvertOrActivateAs がS_OKを返す場合にのみ、ユーザーが使用できるようにする必要があります。
注意
oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUICONVERT を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | oledlg.h |
| Library | OleDlg.lib |
| [DLL] | OleDlg.dll |