Compartilhar via

Função InitOnceComplete (synchapi.h)

  • Artigo

Conclui a inicialização única iniciada com a função InitOnceBeginInitialize .

Sintaxe

BOOL InitOnceComplete(
  [in, out]      LPINIT_ONCE lpInitOnce,
  [in]           DWORD       dwFlags,
  [in, optional] LPVOID      lpContext
);

Parâmetros

[in, out] lpInitOnce

Um ponteiro para a estrutura de inicialização única.

[in] dwFlags

Esse parâmetro pode ser um dos sinalizadores a seguir.

Valor Significado
INIT_ONCE_ASYNC
0x00000002UL
 Operar no modo assíncrono. Isso permite que várias tentativas de conclusão sejam executadas em paralelo. Esse sinalizador deve corresponder ao sinalizador passado na chamada correspondente para a função InitOnceBeginInitialize . Esse sinalizador pode não ser combinado com INIT_ONCE_INIT_FAILED.
INIT_ONCE_INIT_FAILED
0x00000004UL
 Falha na tentativa de inicialização. Esse sinalizador pode não ser combinado com INIT_ONCE_ASYNC. Para falhar uma inicialização assíncrona, simplesmente abandone-a (ou seja, não chame a função InitOnceComplete ).

[in, optional] lpContext

Um ponteiro para os dados a serem armazenados com a estrutura de inicialização única. Esses dados são retornados no parâmetro lpContext passado para chamadas subsequentes para a função InitOnceBeginInitialize . Se lpContext apontar para um valor, a INIT_ONCE_CTX_RESERVED_BITS de ordem baixa do valor deverá ser zero. Se lpContext apontar para uma estrutura de dados, a estrutura de dados deverá ser alinhada a DWORD.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Exemplos

Para obter um exemplo que usa essa função, consulte Usando One-Time Inicialização.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho synchapi.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

InitOnceBeginInitialize

Inicialização única

Funções de sincronização