OleUIChangeIconA 関数 (oledlg.h)

標準の [アイコンの変更 ] ダイアログ ボックスを呼び出します。これにより、ユーザーはアイコン ファイル、実行可能ファイル、または DLL からアイコンを選択できます。

構文

UINT OleUIChangeIconA(
  [in] LPOLEUICHANGEICONA unnamedParam1
);

パラメーター

[in] unnamedParam1

このダイアログ ボックスの In/Out OLEUICHANGEICON 構造体へのポインター。

戻り値

標準の成功/エラー定義

リターン コード 説明
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_CIERR_MUSTHAVECLSID
clsid メンバーが現在の CLSID ではありません。
OLEUI_CIERR_MUSTHAVECURRENTMETAFILE
hMetaPict メンバーが現在のメタファイルではありません。
OLEUI_CIERR_SZICONEXEINVALID
szIconExe 値が無効です。

注釈

OLEUICHANGEICON 構造体。

注意

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

要件

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

こちらもご覧ください

OLEUICHANGEICON