CommDlgExtendedError 関数 (commdlg. h)

[アーティクル]
03/14/2023

ダイアログボックスの一般的なエラーコードを返します。このコードは、一般的なダイアログボックス関数の 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 で導入)