IMAPIViewContext::GetViewStatus
适用于：Outlook 2013 | Outlook 2016
检索当前查看器状态。
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
参数
lpulStatus
[out]指向提供查看器状态的标志的位掩码的指针。 可以设置以下标志：
VCSTATUS_CATEGORY
另一个类别中有下一封或上一封邮件。
VCSTATUS_DELETE
窗体允许删除邮件。
VCSTATUS_INTERACTIVE
窗体应显示用户界面。 如果未设置此标志，则窗体应禁止显示用户界面，即使响应通常会导致显示用户界面的谓词。
VCSTATUS_MODAL
窗体对查看器是模式的。
VCSTATUS_NEXT
视图中有下一条消息。
VCSTATUS_PREV
视图中有上一条消息。
VCSTATUS_READONLY
将在只读模式下打开消息。 应禁用删除、提交和移动操作。
VCSTATUS_UNREAD
视图中有下一条或上一条未读消息。
返回值
S_OK
已成功返回查看者的状态。
备注
窗体对象调用 IMAPIViewContext：：GetViewStatus 方法，以确定在窗体视图中是否在任一方向或两个方向（即 “下一步” 命令激活消息的方向、 “上一步 ”命令激活消息的方向或双向）中激活更多消息。 lpulStatus 参数指向的值用于确定VCSTATUS_NEXT和VCSTATUS_PREV标志是否对 IMAPIViewContext：：ActivateNext 有效。 如果设置了VCSTATUS_DELETE标志，但未设置VCSTATUS_READONLY标志，则可以使用 IMAPIMessageSite：:D eleteMessage 方法删除消息。
通常，窗体禁用菜单命令和按钮（如果它们对查看器的上下文无效）。 查看者可以通过调用其 IMAPIFormAdviseSink：：OnChange 方法来提醒窗体的状态更改。
如果窗体必须是模式的，则设置VCSTATUS_MODAL标志，该窗口的句柄在以前的 IMAPIForm：:D oVerb 调用中传递。 如果设置了VCSTATUS_MODAL，则窗体可以使用执行 DoVerb 调用的线程，直到窗体关闭。 如果未设置VCSTATUS_MODAL，则窗体不应是此窗口的模式，并且不得使用线程。
MFCMAPI 引用
有关 MFCMAPI 示例代码，请参阅下表。
| 文件 | 函数 | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer：：GetViewStatus |
MFCMAPI 在此函数中实现 IMAPIViewContext：：GetViewStatus 方法。 |