Función InitOnceComplete (synchapi.h)

Completa la inicialización única iniciada con la función InitOnceBeginInitialize .

Sintaxis

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

Parámetros

[in, out] lpInitOnce

Puntero a la estructura de inicialización única.

[in] dwFlags

Este parámetro puede ser una de las marcas siguientes.

Valor	Significado
INIT_ONCE_ASYNC 0x00000002UL	Operar en modo asincrónico. Esto permite que se ejecuten varios intentos de finalización en paralelo. Esta marca debe coincidir con la marca pasada en la llamada correspondiente a la función InitOnceBeginInitialize . Es posible que esta marca no se combine con INIT_ONCE_INIT_FAILED.
INIT_ONCE_INIT_FAILED 0x00000004UL	Error en el intento de inicialización. Es posible que esta marca no se combine con INIT_ONCE_ASYNC. Para producir un error en una inicialización asincrónica, simplemente abandone (es decir, no llame a la función InitOnceComplete ).

[in, optional] lpContext

Puntero a los datos que se van a almacenar con la estructura de inicialización única. Estos datos se devuelven en el parámetro lpContext pasado a llamadas posteriores a la función InitOnceBeginInitialize . Si lpContext apunta a un valor, la INIT_ONCE_CTX_RESERVED_BITS de orden inferior del valor debe ser cero. Si lpContext apunta a una estructura de datos, la estructura de datos debe estar alineada con DWORD.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Ejemplos

Para obtener un ejemplo en el que se usa esta función, consulte Using One-Time Initialization (Uso de One-Time inicialización).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	synchapi.h (incluye Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

InitOnceBeginInitialize

Inicialización única

Funciones de sincronización