PINIT_ONCE_FN função de retorno de chamada (synchapi.h)

Uma função de retorno de chamada definida pelo aplicativo. Especifique um ponteiro para essa função ao chamar a função InitOnceExecuteOnce . O tipo PINIT_ONCE_FN define um ponteiro para essa função de retorno de chamada. InitOnceCallback é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PINIT_ONCE_FN PinitOnceFn;

BOOL PinitOnceFn(
  [in, out]           PINIT_ONCE InitOnce,
  [in, out, optional] PVOID Parameter,
  [out, optional]     PVOID *Context
)
{...}

Parâmetros

[in, out] InitOnce

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

[in, out, optional] Parameter

Um parâmetro opcional que foi passado para a função de retorno de chamada.

[out, optional] Context

Os dados a serem armazenados com a estrutura de inicialização única. Se Context fizer referência a um valor, a INIT_ONCE_CTX_RESERVED_BITS de ordem baixa do valor deverá ser zero. Se Context apontar para uma estrutura de dados, a estrutura de dados deverá ser alinhada a DWORD. O contexto não deve ser um ponteiro de código no Arm32, pois os ponteiros de código Arm32 sempre têm o bit menos significativo definido, consulte a ABI arm32 para obter detalhes.

Retornar valor

Se a função retornar TRUE, o bloco será marcado como inicializado.

Se a função retornar FALSE, o bloco não será marcado como inicializado e a chamada para InitOnceExecuteOnce falhará. Para comunicar informações de erro adicionais, chame SetLastError antes de retornar FALSE.

Comentários

Essa função pode criar um objeto de sincronização e retorná-lo no parâmetro lpContext .

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

Confira também

InitOnceExecuteOnce

InitOnceInitialize

Funções de sincronização