Compartilhar via


Estrutura SetProviderStatusInfo (timeprov.h)

Uma estrutura usada pela função SetProviderStatusFunc .

Sintaxe

typedef struct SetProviderStatusInfo {
  TimeProvState                 tpsCurrentState;
  DWORD                         dwStratum;
  LPWSTR                        wszProvName;
  HANDLE                        hWaitEvent;
  SetProviderStatusInfoFreeFunc *pfnFree;
  HRESULT                       *pHr;
  DWORD                         *pdwSysStratum;
} SetProviderStatusInfo;

Membros

tpsCurrentState

O novo estado do provedor. Esse membro pode ser um dos seguintes valores:

TPC_Error

TPS_Running

dwStratum

O novo estrato do provedor. Computadores que usam um relógio de hardware (como césio, GPS ou rádio) para manter o tempo são estrato 1. Os computadores que sincronizam seu tempo com outro computador pela rede são o estrato N+1, em que N é o estrato do computador com o qual estão sincronizando.

wszProvName

O nome do provedor.

hWaitEvent

Um identificador para um evento a ser definido como o estado sinalizado quando a operação tiver sido concluída. Para criar um objeto de evento, use a função CreateEvent .

Se a notificação não for necessária, esse membro poderá ser NULL.

pfnFree

Um ponteiro para uma função SetProviderStatusInfoFreeFunc que libera a estrutura após a conclusão.

pHr

Após a conclusão, esse membro contém o resultado da operação. Se a operação for bem-sucedida, o resultado será S_OK. Caso contrário, o resultado será um dos códigos de erro definidos em WinError.h.

pdwSysStratum

Após a conclusão, esse membro contém o novo estrato do sistema. O estrato do sistema é o estrato mais baixo de todos os provedores de tempo no sistema. Se o provedor de tempo com o estrato mais baixo incrementar seu estrato, isso incrementará o estrato do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho timeprov.h

Confira também

SetProviderStatusFunc

SetProviderStatusInfoFreeFunc