PrinterMessageBox功能显示一个消息框,允许正在打印的应用程序通知用户打印作业错误。如果作业的所有者远程登录,该函数会向所有者发送一个网络弹出窗口。如果用户在消息框中选择“取消”,该函数将取消打印作业;否则,该函数将清除作业错误状态,系统再次尝试打印作业。
HPRINTER PrinterMessageBox(
HANDLE 【hPrinter】, | //打印机的句柄 |
DWORD 【错误】, | //错误标识符 |
HWND 【的hWnd】, | //所有者窗口的句柄 |
LPTSTR 【pText】, | //指向消息框文本的指针 |
LPTSTR 【pCaption】, | //指向消息框标题的指针 |
DWORD 【dwType】 | //样式的消息框 |
); |
参数
【hPrinter】
标识作业发送到的打印机。
【错误】
指定发生的错误。此参数可以是以下值之一:
值 | 含义 |
ERROR_OUT_OF_PAPER | 打印机缺纸。 |
ERROR_NOT_READY | 打印机尚未就绪。 |
【的hWnd】
标识函数创建的消息框的所有者窗口。如果此参数为NULL,则消息框不具有所有者窗口。
【pText】
指向指定要显示的消息的以null结尾的字符串。
【pCaption】
指向指定对话框标题的以null结尾的字符串。如果此参数为NULL,则该函数使用默认标题“Error”。
【dwType】
指定对话框的内容和行为。该参数可以是MessageBox函数的第四个参数接受的任何值的组合;但是,建议应用程序使用以下组合:
MB_ICONSTOP | MB_RETRYCANCEL | MB_SETFOREGROUND
返回值
如果PrinterMessageBox发送一个网络弹出窗口,返回值为IDOK。否则,函数返回函数显示的消息框返回的值。两个典型的返回值如下:
值 | 含义 |
IDCANCEL | 取消按钮被选中。 |
IDRETRY | 已选择重试按钮。 |
有关消息框返回值的更完整列表,请参阅MessageBox.
也可以看看