### 函数功能

该函数清除一个模态对话框,并使系统中止对对话框的任何处理。

### 函数原型

BOOL EndDialog(HWND hDlg,int nResult);

### 参数

hDlg：表示要被清除的对话框窗口。
NResult：指定从创建对话框函数返回到应用程序的值。

### 返回值

如果函数调用成功，则返回值为非零值；如果函数调用失败则返回值为零。若想获得错误信息请调用GetLastError函数。
备注：由DialogBox，DialogBoxParam、DialogBoxlndirect和DialogBoxlndirectParam函数创建的对话框一定要用EndDialog函数来清除。应用程序从对话框应用程序内部调用EndDialog函数，该函数不能为其他目的而供使用。对话框应用程序可以在任何时间调用EndDialog函数；甚至在WM_INITDIALOG消息处理过程中。如果应用程序在WM_INTDIALOG消息处理过程中调用该函数，则对话框在显示和输入焦点被设置之前对话框被清除。EndDialog函数并不立即清除对话框。而是设置一个标志，并且允许对话框应用程序把控制权返回系统。系统在试图从应用程序队列检索下一个消息之前检测标志。如果已经设置了标志则系统中止消息循环,清除对话框,且用nResUlt中的值作为从创建对话框的函数中返回的值。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；库文件：user32.lib。