Compartilhar via


IAgentCharacter::GetVisibilityCause

[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]

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

Recupera a causa do estado visível do caractere.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

pdwCause

Endereço de uma variável que recebe a causa da última mudança de estado de visibilidade do caractere, que será um dos seguintes:

Valor Descrição
const unsigned short NeverShown = 0;
O caractere não foi mostrado.
const unsigned short UserHid = 1;
O usuário ocultou o caractere com o menu pop-up do ícone da barra de tarefas do caractere ou usando a entrada de fala.
const unsigned short UserShowed = 2;
O usuário mostrou o caractere.
const unsigned short ProgramHid = 3;
O aplicativo ocultou o caractere.
const unsigned short ProgramShowed = 4;
O aplicativo mostrou o caractere.
const unsigned short OtherProgramHid = 5;
Outro aplicativo escondeu o caractere.
const unsigned short OtherProgramShowed = 6;
Outro aplicativo mostrou o caractere.
const unsigned short UserHidViaCharacterMenu = 7
O usuário ocultou o caractere com o menu pop-up do caractere.
const unsigned short UserHidViaTaskbarIcon = UserHid
O usuário ocultou o caractere com o menu pop-up do ícone da barra de tarefas do caractere ou usando a entrada de fala.

Confira também

IAgentNotifySink::VisibleState