Compartilhar via

Método IWTSSBPlugin::WTSSBX_MachineChangeNotification (tssbx.h)

  • Artigo

[Não há suporte para a interface IWTSSBPlugin após o Windows Server 2008 R2. Começando com Windows Server 2012 use a interface ITsSbPlugin.]

Notifica o plug-in de que ocorreu uma alteração no ambiente do servidor.

Sintaxe

HRESULT WTSSBX_MachineChangeNotification(
  [in] WTSSBX_NOTIFICATION_TYPE NotificationType,
  [in] long                     MachineId,
  [in] WTSSBX_MACHINE_INFO      *pMachineInfo
);

Parâmetros

[in] NotificationType

Um valor do tipo de enumeração WTSSBX_NOTIFICATION_TYPE que indica o tipo de evento que ocorreu.

[in] MachineId

A ID do servidor no qual a alteração ocorreu.

[in] pMachineInfo

Um ponteiro para uma estrutura WTSSBX_MACHINE_INFO que contém informações sobre o servidor que foi alterado. Somente os membros alterados são relatados nessa estrutura. Os outros membros são definidos como zero.

Retornar valor

Retorna S_OK se tiver êxito.

Comentários

O Agente de Sessão dos Serviços de Terminal (Agente de Sessão TS) chama esse método sempre que ocorre uma alteração importante no ambiente do servidor. Por exemplo, as alterações que disparariam uma chamada incluem quando:

  • Um servidor ingressa ou sai de um farm no Agente de Sessão do TS.
  • Um servidor altera seu estado de esvaziamento.
  • Um endereço IP do servidor é alterado.
  • O limite máximo de sessão de um servidor é alterado.
Sua implementação desse método deve retornar S_OK imediatamente se tiver êxito.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho tssbx.h

Confira também

ITsSbPlugin

IWTSSBPlugin