IAgentCharacter：：GetVisibilityCause

[Microsoft代理程式從 Windows 7 開始已被取代，而且可能無法在後續版本的 Windows 中使用。]

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

擷取字元可見狀態的原因。

• 傳回S_OK，表示作業成功。

pdwCause

接收字元上次可見度狀態變更原因的變數位址，且會是下列其中一項：

值	Description
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