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 |
|---|---|
|
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. |
|
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 |