CommDlgExtendedError işlevi bir ortak iletişim kutusunda hata kodu döndürür. Bu kod aşağıdaki ortak iletişim kutusu işlevlerinden birini yürütülürken gerçekleşmesi için en son hata olduğunu gösterir.:
| ChooseColor | GetOpenFileName |
| ChooseFont | GetSaveFileName |
| FindText | PrintDlg |
| ReplaceText | PageSetupDlg |
Dword CommDlgExtendedError(VOID)
Bu işlev parametre vardır.
En son çağrısı ortak bir iletişim kutusu işlevi başarılı ise, dönüş değeri tanımsız.
Çünkü kullanıcı kapalı veya iletişim kutusunu iptal ortak iletişim kutusu işlevi false döndürülürse, dönüş değeri sıfırdır. Aksi takdirde, dönüş değeri sıfır hata kodudur. Daha fazla bilgi için aşağıdaki açıklamalar bölümüne bakın.
CommDlgExtendedError işlevi ortak iletişim kutusunun işlevlerini genel hata kodlarını döndürür. Ayrıca, yalnızca belirli bir ortak iletişim kutusu için döndürülen hata kodları vardır. CommDlgExtendedError tarafından döndürülen hata kodları cderr tanımlanır.H dosyası.
Herhangi bir ortak iletişim kutusundaki işlevler için aşağıdaki genel hata kodları döndürülebilir:
| Değer | Anlamı |
|---|---|
| CDERR_DIALOGFAILURE | İletişim kutusu oluşturulamadı. İletişim kutusu işlevi ortak iletişim kutusu işlevin çağrısı başarısız oldu. Geçersiz pencere işleci ortak iletişim kutusu arama belirtir, örneğin, bu hata oluşur. |
| CDERR_FINDRESFAILURE | Belirtilen kaynak bulmak ortak iletişim kutusu işlevi başarısız oldu. |
| CDERR_INITIALIZATION | Ortak iletişim kutusu işlevi, başlatma sırasında başarısız oldu. Bu hata, genellikle yeterli bellek olmadığında oluşur. |
| CDERR_LOADRESFAILURE | Ortak iletişim kutusu işlevi belirtilen kaynağı yüklenemedi. |
| CDERR_LOADSTRFAILURE | Ortak iletişim kutusu işlevi belirtilen bir dize yüklenemedi. |
| CDERR_LOCKRESFAILURE | Ortak iletişim kutusu işlevi belirtilen kaynak kilit alınamadı. |
| CDERR_MEMALLOCFAILURE | Ortak iletişim kutusu işlevi, iç yapıları için bellek ayıramadı. |
| CDERR_MEMLOCKFAILURE | Ortak iletişim kutusu işlevi bir kolu ile ilişkili bellek kilit alamadı. |
| CDERR_NOHINSTANCE | Bayraklar üyesini, karşılık gelen ortak iletişim kutusu başlatma yapısı enabletemplate bayrağı ayarlandı, ancak karşılık gelen örnek tanıtıcı sağlamak için başarısız. |
| CDERR_NOHOOK | Enablehook bayrak bayrakları üyesini, karşılık gelen ortak iletişim kutusu başlatma yapısı kuruldu, ancak karşılık gelen bir kanca işlemi için bir işaretçi sağlamak için başarısız. |
| CDERR_NOTEMPLATE | Bayraklar üyesini, karşılık gelen ortak iletişim kutusu başlatma yapısı enabletemplate bayrağı ayarlandı, ancak karşılık gelen şablon sağlamak için başarısız. |
| CDERR_REGISTERMSGFAIL | Ortak iletişim kutusu işlevi tarafından çağrıldığında RegisterWindowMessage işlevi bir hata kodu döndürdü. |
| CDERR_STRUCTSIZE | LStructSize üye ilgili ortak iletişim kutusu başlatma yapısı geçersiz. |
PrintDlg işlevi aşağıdaki hata kodları döndürülebilir:
| Değer | Anlamı |
|---|---|
| PDERR_CREATEICFAILURE | Bir bilgi içerik oluşturmaya çalışırken PrintDlg işlevi başarısız oldu. |
| PDERR_DEFAULTDIFFERENT | devnames yapısı wDefault üyesi belirtilen dn_defaultprn bayrağıyla PrintDlg fonksiyonu denir, ama diğer Yapı üyeleri tarafından açıklanan yazıcının geçerli varsayılan yazıcı eşleşmedi. (Bu hata devnames yapısını depolamak ve Denetim Masası'nı kullanarak varsayılan yazıcı kullanıcı değişiklikleri gerçekleşir.) |
| devnames yapı tarafından açıklanan yazıcıyı kullanmak için dn_defaultprn bayrağını temizleyin ve PrintDlg tekrar arama. Varsayılan yazıcıyı kullanmak için devnames yapısını değiştirmek (ve varsa, devmode yapısını,) ile null; ve PrintDlg tekrar arama. |
|
| PDERR_DNDMMISMATCH | devmode ve devnames yapıları veri iki farklı yazıcılar açıklar. |
| PDERR_GETDEVMODEFAIL | Yazıcı sürücüsü, devmode yapısını başlatamadı. (Bu hata kodu yalnızca yazıcı sürücüleri için yazılı for Windows sürüm 3.0 ve sonraki uygulanır.) |
| PDERR_INITFAILURE | PrintDlg işlevi, başlatma sırasında başarısız oldu ve orada başarısızlığı tanımlamak için daha fazla özel genişletilmiş hata kodu. Bu işlev genel varsayılan hata kodudur. |
| PDERR_LOADDRVFAILURE | PrintDlg işlevi, belirtilen yazıcı aygıt sürücüsü yüklenemedi. |
| PDERR_NODEFAULTPRN | Varsayılan yazıcı yok. |
| PDERR_NODEVICES | Hiçbir yazıcı sürücüsü bulunamadı. |
| PDERR_PARSEFAILURE | PrintDlg işlevi, WIN [devices] bölümünde dizeleri ayrıştıramadı.INI dosyası. |
| PDERR_PRINTERNOTFOUND | WIN [devices] bölümü.INI dosyası istenen yazıcı için bir girdi içermiyor. |
| PDERR_RETDEFFAILURE | Pd_returndefault bayrağı PRINTDLG yapısını bayrakları üyesi belirtildi, ancak hDevMode veya hDevNames üye null değil. |
| PDERR_SETUPFAILURE | PrintDlg işlevi, gerekli kaynakları yüklenemedi. |
ChooseFont işlevi aşağıdaki hata kodları döndürülebilir:
| Değer | Anlamı |
|---|---|
| CFERR_MAXLESSTHANMIN | choosefont yapısının nSizeMax üyesinin belirtilen boyutta nSizeMin üye belirtilen boyutu küçüktür. |
| CFERR_NOFONTS | Hiçbir yazı var. |
GetOpenFileName ve GetSaveFileName işlevleri aşağıdaki hata kodları döndürülebilir:
| Değer | Anlamı |
|---|---|
| FNERR_BUFFERTOOSMALL | OPENDOSYAADI yapısı lpstrFile üyesi tarafından işaret arabellek çok küçük kullanıcı tarafından belirtilen dosya adı. İlk iki baytı lpstrFile arabellek boyutu, bayt (ANSI sürümü) veya 16-bit karakter (Unicode sürümü), tam adı almak için gerekli belirten bir tamsayı değer içeren. |
| FNERR_INVALIDFILENAME | Dosya adı geçersiz. |
| FNERR_SUBCLASSFAILURE | Alt sınıf bir girişim bir liste kutusu başarısız oldu, çünkü yeterli bellek yoktu. |
Aşağıdaki hata kodu FindText ve ReplaceText işlevleri için döndürülebilir:
| Değer | Anlamı |
|---|---|
| FRERR_BUFFERLENGTHZERO | Üye FINDREPLACE yapısı geçersiz bir arabelleğe işaret eder. |
Windows ce: Windows ce dört ek dönüş değerlerini destekler
PrintDlg fonksiyonu yalnızca aşağıdaki dönüş değerlerini uygulamak:
Windows ce, CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE ya da CDERR_REGISTERMSGFAIL dönüş değerlerini desteklemez.
Windows ce pderr_ hata değerlerinin hiçbirini desteklemiyor.
nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:Commdlg.h ilan etti.
İçe Library:Comdlg32.lib kullanma.
Ortak iletişim kutusuna kitaplığın genel bakış, ortak iletişim kutusundaki işlevler, ChooseColor, choosecolor, ChooseFont, choosefont, devmode, devnames, iletişim kutusu, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENDOSYAADI, PageSetupDlg, pagesetupdlg, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText