Função InitOnceComplete (synchapi.h)
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 |
|---|---|
|
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. |
|
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 |