Edit

Share via

RegisterWaitUntilOOBECompleted function (oobenotification.h)

  • Article

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

Syntax

BOOL RegisterWaitUntilOOBECompleted(
  OOBE_COMPLETED_CALLBACK OOBECompletedCallback,
  PVOID                   CallbackContext,
  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 null.

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

Requirement Value
Target Platform Windows
Header oobenotification.h
Library Kernel32.lib
DLL Kernel32.dll