SetupInitDefaultQueueCallback function (setupapi.h)

Article
02/22/2024

[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

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	setupapi.h
Library	Setupapi.lib
DLL	Setupapi.dll