CommDlgExtendedError 函式 (commdlg.h)

發行項
02/24/2024

傳回常見的對話框錯誤碼。此程式代碼表示在執行其中一個通用對話框函式期間，要發生的最近錯誤。

Syntax

DWORD CommDlgExtendedError();

傳回值

類型： DWORD

如果最近呼叫通用對話框函式成功，則傳回值是未定義的。如果常見的對話框函式因為使用者關閉或取消對話框而傳回 FALSE ，則傳回值為零。否則，傳回值是非零的錯誤碼。

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	ENABLEHOOK 旗標是在對應通用對話框之初始化結構的 Flags 成員中設定，但您無法提供對應勾點程式的指標。
CDERR_NOTEMPLATE 0x0003	ENABLETEMPLATE 旗標是在對應通用對話方塊之初始化結構的 Flags 成員中設定，但無法提供對應的範本。
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 。若要使用預設印表機，) 請以 NULL 取代 DEVNAMES 結構 (和結構;並再次呼叫 PrintDlg。
PDERR_DNDMMISMATCH 0x1009	DEVMODE 和 DEVNAMES 結構中的數據描述兩個不同的印表機。
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 緩衝區的前兩個字節包含整數值，指定接收完整名稱所需的大小，以字元為單位。
FNERR_INVALIDFILENAME 0x3002	檔名無效。
FNERR_SUBCLASSFAILURE 0x3001	嘗試子類別清單框失敗，因為沒有足夠的記憶體可用。

FindText 和 ReplaceText 函式可以傳回下列錯誤碼。

傳回碼/值	Description
FRERR_BUFFERLENGTHZERO 0x4001	FINDREPLACE 結構的成員指向無效的緩衝區。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	commdlg.h (包含 Windows.h)
程式庫	Comdlg32.lib
Dll	Comdlg32.dll
API 集合	ext-ms-win-shell-comdlg32-l1-1-0 (在 Windows 10 10.0.10240 版中引進)