Compartilhar via

Método IWinSATInitiateEvents::WinSATUpdate (winsatcominterfacei.h)

  • Artigo

[IWinSATInitiateEvents::WinSATUpdate pode ser alterado ou indisponível para versões após Windows 8.1.]

Recebe uma notificação quando uma avaliação está progredindo.

Sintaxe

HRESULT WinSATUpdate(
  [in] UINT    uCurrentTick,
  [in] UINT    uTickTotal,
  [in] LPCWSTR strCurrentState
);

Parâmetros

[in] uCurrentTick

O tique de progresso atual da avaliação.

[in] uTickTotal

O número total de tiques de progresso para a avaliação.

[in] strCurrentState

Uma cadeia de caracteres que contém o estado atual da avaliação. Essa cadeia de caracteres é válida durante a vida útil desse retorno de chamada. Copie a cadeia de caracteres se precisar dela depois que o retorno de chamada retornar.

Retornar valor

Esse método deve retornar S_OK; o valor é ignorado.

Comentários

Você pode usar esse método para determinar o progresso de uma avaliação formal.

Nota Você pode usar os valores uCurrentTick e uTickTotal para marcar o progresso apenas para avaliações formais; os valores são zero para todas as outras avaliações.
 
Você deve manter sua implementação curta para não perder as atualizações subsequentes; você não receberá novas atualizações até que o método retorne.
Nota Se uma instância do WinSAT já estiver em execução, é possível que você possa receber um ou mais retornos de chamada de atualização para a avaliação em execução no momento.
 

Exemplos

Para obter um exemplo de implementação, consulte o método InitiateAssessment ou InitiateFormalAssessment de IInitiateWinSATAssessment.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho winsatcominterfacei.h
DLL Winsatapi.dll

Confira também

IInitiateWinSATAssessment

IWinSATInitiateEvents

IWinSATInitiateEvents::WinSATComplete