The MsiPreviewBillboard function displays a billboard with the host control in the displayed dialog box.

Syntax

C++UINT MsiPreviewBillboard(
  __in  MSIHANDLE hPreview,
  __in  LPCTSTR szControlName,
  __in  LPCTSTR szBillboard
);

Parameters

hPreview [in]

Handle to the preview.

szControlName [in]

Specifies the name of the host control.

szBillboard [in]

Specifies the name of the billboard to display.

Return Value

ERROR_FUNCTION_FAILED

The function failed.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_PARAMETER

An invalid parameter was supplied.

ERROR_SUCCESS

The function succeeded.

Remarks

Supplying a null billboard name in the MsiPreviewBillboard function removes any billboard displayed.

Requirements

See Also

User Interface Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009