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 shortNeverShown = 0;
O caractere não foi mostrado.
const unsigned shortUserHid = 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 shortUserShowed = 2;
O usuário mostrou o caractere.
const unsigned shortProgramHid = 3;
O aplicativo ocultou o caractere.
const unsigned shortProgramShowed = 4;
O aplicativo mostrou o caractere.
const unsigned shortOtherProgramHid = 5;
Outro aplicativo escondeu o caractere.
const unsigned shortOtherProgramShowed = 6;
Outro aplicativo mostrou o caractere.
const unsigned shortUserHidViaCharacterMenu = 7
O usuário ocultou o caractere com o menu pop-up do caractere.
const unsigned shortUserHidViaTaskbarIcon = 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