SetupInitDefaultQueueCallback function (setupapi.h)

[This function is available for use in the operating systems indicated in the Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI continues to be used for installing device drivers.]

The SetupInitDefaultQueueCallback function initializes the context used by the default queue callback routine included with the Setup API.

Syntax

WINSETUPAPI PVOID SetupInitDefaultQueueCallback(
  [in] HWND OwnerWindow
);

Parameters

[in] OwnerWindow

Handle to the window to use as the parent of any dialog boxes generated by the default callback routine.

Return value

Pointer to the context used by the default queue callback routine.

If the call to SetupInitDefaultQueueCallback fails, the function returns a PVOID value of null.

To get extended error information, call GetLastError.

Remarks

Regardless of whether you initialized the context used by the default queue callback routine with SetupInitDefaultQueueCallback or SetupInitDefaultQueueCallbackEx, after the queued operations have finished processing, call SetupTermDefaultQueueCallback to release the resources allocated in initializing the context structure. For more information, see Initializing and Terminating the Callback Context.

Requirements

See also

Functions

Overview

SetupDefaultQueueCallback

SetupInitDefaultQueueCallbackEx