IAgentCharacter：：GetVisibilityCause

[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 Windows 中不可用。]

HRESULT GetVisibilityCause(
   long * pdwCause  // address of variable for cause of character visible state
);

检索字符的可见状态的原因。

• 返回指示操作成功的S_OK。

pdwCause

接收字符上次可见性状态更改的原因的变量的地址，该变量将是以下变量之一：

值	说明
const unsigned shortNeverShown = 0;	尚未显示字符。
const unsigned shortUserHid = 1;	用户使用字符的任务栏图标弹出菜单或使用语音输入隐藏字符。
const unsigned shortUserShowed = 2;	用户显示了 字符。
const unsigned shortProgramHid = 3;	应用程序隐藏了字符。
const unsigned shortProgramShowed = 4;	应用程序显示了 字符。
const unsigned shortOtherProgramHid = 5;	另一个应用程序隐藏了字符。
const unsigned shortOtherProgramShowed = 6;	另一个应用程序显示了 字符。
const unsigned shortUserHidViaCharacterMenu = 7	用户使用字符的弹出菜单隐藏了字符。
const unsigned shortUserHidViaTaskbarIcon = UserHid	用户使用字符的任务栏图标弹出菜单或使用语音输入隐藏字符。

另请参阅

IAgentNotifySink：：VisibleState