Compartilhar via


Função TimeProvOpen (timeprov.h)

Uma função de retorno de chamada que é chamada pelo gerenciador de provedores de tempo quando a DLL do provedor de tempo é carregada.

Sintaxe

HRESULT TimeProvOpen(
  [in]  PWSTR                wszName,
  [in]  TimeProvSysCallbacks *pSysCallbacks,
  [out] TimeProvHandle       *phTimeProv
);

Parâmetros

[in] wszName

O nome do provedor.

[in] pSysCallbacks

Um ponteiro para uma estrutura TimeProvSysCallbacks que especifica ponteiros para as funções fornecidas pelo serviço de hora para o provedor de tempo. O sistema aloca essa estrutura e é destruída quando a função retorna. Portanto, você deve copiar as informações para outro buffer.

[out] phTimeProv

Um ponteiro para um buffer que contém um identificador para o provedor. O gerenciador de provedores de tempo usa esse identificador para se comunicar com o provedor de tempo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será S_OK. Caso contrário, o valor retornado será um dos códigos de erro definidos em WinError.h.

Comentários

Você deve retornar dessa função de retorno de chamada o mais rápido possível. Executar qualquer inicialização em outro thread.

Exemplos

Para obter um exemplo, consulte Provedor de Tempo de Exemplo.

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]
Plataforma de Destino Windows
Cabeçalho timeprov.h

Confira também

AlertSamplesAvailFunc

GetTimeSysInfoFunc

LogTimeProvEventFunc

SetProviderStatusFunc

TimeProvSysCallbacks