RegisterWaitUntilOOBECompleted function

Registers a callback to be called once OOBE (Windows Welcome) has been completed.

Syntax

BOOL WINAPI RegisterWaitUntilOOBECompleted(
   _In_ OOBE_COMPLETED_CALLBACK OOBECompletedCallback,
   _In_opt_ PVOID               CallbackContext,
   _Out_ PVOID *                WaitHandle
);

Parameters

OOBECompletedCallback

Pointer to an application-defined callback function that will be called upon completion of OOBE. For more information, see OOBE_COMPLETED_CALLBACK.

CallbackContext

Pointer to the callback context. This value will be passed to the function specified by OOBECompletedCallback. This value can be nulll.

WaitHandle

Pointer to a variable that will receive the handle to the wait callback registration.

Return value

TRUE if the routine successfully registered the callback. Otherwise, FALSE is returned. If FALSE, GetLastError will retrieve extended error information.

Remarks

If RegisterWaitUntilOOBECompleted returns FALSE, and a subsequent call to GetLastError returns a value of ERROR_INVALID_STATE, this indicates that OOBE is already complete and there is no need to register for OOBE completion.

Requirements