共用方式為


CommDlgExtendedError 函式 (commdlg.h)

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

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
DEVMODEDEVNAMES 結構中的數據描述兩個不同的印表機。
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 成員中指定,但 hDevModehDevNames 成員不是 NULL
PDERR_SETUPFAILURE
0x1001
PrintDlg 函式無法載入所需的資源。
 

ChooseFont 函式可以傳回下列錯誤碼。

傳回碼/值 Description
CFERR_MAXLESSTHANMIN
0x2002
CHOOSEFONT 結構的 nSizeMax 成員中指定的大小小於 nSizeMin 成員中指定的大小。
CFERR_NOFONTS
0x2001
沒有字型存在。
 

您可以針對 GetOpenFileNameGetSaveFileName 函式傳回下列錯誤碼。

傳回碼/值 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 版中引進)

另請參閱

CHOOSECOLOR

CHOOSEFONT

ChooseColor

ChooseFont

通用對話框連結庫

概念

DEVNAMES

DialogBox

FINDREPLACE

FindText

GetOpenFileName

GetSaveFileName

OPENFILENAME

PAGESETUPDLG

PRINTDLG

PageSetupDlg

PrintDlg

參考

RegisterWindowMessage

ReplaceText