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
 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 版中引進)

另請參閱

CHOOSECOLOR

CHOOSEFONT

ChooseColor

ChooseFont

通用對話框連結庫

概念

DEVNAMES

DialogBox

FINDREPLACE

FindText

GetOpenFileName

GetSaveFileName

OPENFILENAME

PAGESETUPDLG

PRINTDLG

PageSetupDlg

PrintDlg

參考

RegisterWindowMessage

ReplaceText