CommDlgExtendedError 関数 (commdlg. h)

ダイアログ ボックスの一般的なエラー コードを返します。 このコードは、一般的なダイアログ ボックス関数の 1 つの実行中に発生する最新のエラーを示します。

構文

DWORD CommDlgExtendedError();

戻り値

型: DWORD

共通ダイアログ ボックス関数の最新の呼び出しに成功した場合、戻り値は未定義です。 ユーザーがダイアログ ボックスを閉じたか取り消したために共通ダイアログ ボックス関数が FALSE を 返した場合、戻り値は 0 になります。 それ以外の場合、戻り値は 0 以外のエラー コードです。

CommDlgExtendedError 関数は、一般的なダイアログ ボックス関数の一般的なエラー コードを返すことができます。 さらに、特定の共通ダイアログ ボックスに対してのみ返されるエラー コードがあります。 これらのエラー コードはすべて Cderr.h で定義されています。 次の一般的なエラー コードは、一般的なダイアログ ボックス関数のいずれかに対して返すことができます。

リターン コード/値 Description
CDERR_DIALOGFAILURE
0xFFFF
ダイアログ ボックスを作成できませんでした。 ダイアログ ボックス関数の DialogBox 関数の呼び出しが失敗しました。 たとえば、一般的なダイアログ ボックス呼び出しで無効なウィンドウ ハンドルが指定されている場合、このエラーが発生します。
CDERR_FINDRESFAILURE
0x0006
共通ダイアログ ボックス関数は、指定されたリソースを見つけることができませんでした。
CDERR_INITIALIZATION
0x0002
初期化中に共通のダイアログ ボックス関数が失敗しました。 このエラーは、多くの場合、十分なメモリが使用できない場合に発生します。
CDERR_LOADRESFAILURE
0x0007
共通ダイアログ ボックス関数は、指定されたリソースを読み込めませんでした。
CDERR_LOADSTRFAILURE
0x0005
共通ダイアログ ボックス関数は、指定された文字列を読み込めませんでした。
CDERR_LOCKRESFAILURE
0x0008
共通ダイアログ ボックス関数は、指定されたリソースをロックできませんでした。
CDERR_MEMALLOCFAILURE
0x0009
共通ダイアログ ボックス関数は、内部構造体にメモリを割り当てることができませんでした。
CDERR_MEMLOCKFAILURE
0x000A
共通ダイアログ ボックス関数は、ハンドルに関連付けられているメモリをロックできませんでした。
CDERR_NOHINSTANCE
0x0004
ENABLETEMPLATE フラグは、対応する共通ダイアログ ボックスの初期化構造の Flags メンバーで設定されましたが、対応するインスタンス ハンドルを指定できませんでした。
CDERR_NOHOOK
0x000B
対応する共通ダイアログ ボックスの初期化構造体の Flags メンバーに ENABLEHOOK フラグが設定されましたが、対応するフック プロシージャへのポインターを指定できませんでした。
CDERR_NOTEMPLATE
0x0003
対応する共通ダイアログ ボックスの初期化構造体の Flags メンバーで ENABLETEMPLATE フラグが設定されましたが、対応するテンプレートを指定できませんでした。
CDERR_REGISTERMSGFAIL
0x000C
RegisterWindowMessage 関数は、共通ダイアログ ボックス関数によって呼び出されたときにエラー コードを返しました。
CDERR_STRUCTSIZE
0x0001
対応する共通ダイアログ ボックスの初期化構造体の lStructSize メンバーが無効です。
 

PrintDlg 関数では、次のエラー コードを返すことができます。

リターン コード/値 Description
PDERR_CREATEICFAILURE
0x100A
PrintDlg 関数は、情報コンテキストを作成しようとしたときに失敗しました。
PDERR_DEFAULTDIFFERENT
0x100C
DEVNAMES 構造体の wDefault メンバーで指定されたDN_DEFAULTPRN フラグを使用して PrintDlg 関数を呼び出しましたが、他の構造体メンバーによって記述されたプリンターが現在の既定のプリンターと一致しませんでした。 このエラーは、DEVNAMES 構造体を格納し、ユーザーが コントロール パネルを使用して既定のプリンターを変更した場合に発生します。

DEVNAMES 構造体で記述されているプリンターを使用するには、DN_DEFAULTPRN フラグをクリアし、PrintDlg をもう一度呼び出します。

既定のプリンターを使用するには、 DEVNAMES 構造体 (および構造体が存在する場合は 構造体) を NULL に置き換えます。 PrintDlg をもう一度呼び出します。

PDERR_DNDMMISMATCH
0x1009
DEVMODE 構造体と DEVNAMES 構造体内のデータは、2 つの異なるプリンターについて説明します。
PDERR_GETDEVMODEFAIL
0x1005
プリンター ドライバーが DEVMODE 構造体を初期化できませんでした。
PDERR_INITFAILURE
0x1006
PrintDlg 関数は初期化中に失敗し、エラーを記述するための拡張エラー コードはこれ以上ありません。 これは、関数の一般的な既定のエラー コードです。
PDERR_LOADDRVFAILURE
0x1004
PrintDlg 関数は、指定されたプリンターのデバイス ドライバーを読み込めませんでした。
PDERR_NODEFAULTPRN
0x1008
既定のプリンターが存在しません。
PDERR_NODEVICES
0x1007
プリンター ドライバーが見つかりませんでした。
PDERR_PARSEFAILURE
0x1002
PrintDlg 関数は、WIN.INI ファイルの [devices] セクションの文字列を解析できませんでした。
PDERR_PRINTERNOTFOUND
0x100B
WIN.INI ファイルの [devices] セクションに、要求されたプリンターのエントリが含まれていませんでした。
PDERR_RETDEFFAILURE
0x1003
PD_RETURNDEFAULT フラグは PRINTDLG 構造体の Flags メンバーで指定されましたが、hDevMode メンバーまたは hDevNames メンバーは NULL ではありません。
PDERR_SETUPFAILURE
0x1001
PrintDlg 関数は、必要なリソースを読み込めませんでした。
 

ChooseFont 関数では、次のエラー コードを返すことができます。

リターン コード/値 Description
CFERR_MAXLESSTHANMIN
0x2002
CHOOSEFONT 構造体の nSizeMax メンバーで指定されたサイズが、nSizeMin メンバーで指定されたサイズより小さい。
CFERR_NOFONTS
0x2001
フォントは存在しません。
 

GetOpenFileName 関数と GetSaveFileName 関数では、次のエラー コード返すことができます。

リターン コード/値 Description
FNERR_BUFFERTOOSMALL
0x3003
OPENFILENAME 構造体の lpstrFile メンバーが指すバッファーが、ユーザーが指定したファイル名に対して小さすぎます。 lpstrFile バッファーの最初の 2 バイトには、完全な名前を受け取るために必要なサイズを文字数で指定する整数値が含まれています。
FNERR_INVALIDFILENAME
0x3002
ファイル名が無効です。
FNERR_SUBCLASSFAILURE
0x3001
十分なメモリが使用できなかったため、リスト ボックスをサブクラス化できませんでした。
 

FindText 関数と ReplaceText 関数では、次のエラー コードを返すことができます。

リターン コード/値 Description
FRERR_BUFFERLENGTHZERO
0x4001
FINDREPLACE 構造体のメンバーが無効なバッファーを指しています。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー commdlg.h (Windows.h を含む)
Library Comdlg32.lib
[DLL] Comdlg32.dll
API セット ext-ms-win-shell-comdlg32-l1-1-0 (Windows 10 バージョン 10.0.10240 で導入)

こちらもご覧ください

CHOOSECOLOR

CHOOSEFONT

ChooseColor

ChooseFont

共通ダイアログ ボックス ライブラリ

概念

DEVNAMES

ダイアログ

FINDREPLACE

Findtext

GetOpenFileName

GetSaveFileName

OPENFILENAME

PAGESETUPDLG

PRINTDLG

PageSetupDlg

PrintDlg

リファレンス

RegisterWindowMessage

ReplaceText