AsyncInstallDistributionUnit function

Installs the specified component.

Syntax

HRESULT AsyncInstallDistributionUnit(
             LPCWSTR  szDistUnit,
             LPCWSTR  szTYPE,
             LPCWSTR  szExt,
             DWORD    dwFileVersionMS,
             DWORD    dwFileVersionLS,
             LPCWSTR  szURL,
             IBindCtx *pbc,
  _Reserved_ LPVOID   pvReserved,
             DWORD    flags
);

Parameters

szDistUnit

A pointer to a string that specifies the name of the component.

szTYPE

A pointer to a string that specifies the MIME type of the component. This parameter is used to generate a CLSID for the component.

szExt

A pointer to a string that specifies the extension. If szTYPE is not specified, this parameter is used to generate a CLSID for this component.

dwFileVersionMS

A value of type DWORD that specifies the major version number of the component. When the version is indicated by four words, #Version=a,b,c,d; dwFileVersionMS indicates a with the high-order word and b with the low-order word.

Copy

DWORD dwFileVersionMS = (a << 16)|b;

dwFileVersionLS

A value of type DWORD that specifies the minor version number of the component. When the version is indicated by four words, #Version=a,b,c,d; dwFileVersionLS indicates c with the high-order word and d with the low-order word.

Copy

DWORD dwFileVersionLS = (c << 16)|d;

szURL

A pointer to a string that specifies the URL of the component.

pbc

A pointer to an IBindCtx interface that specifies the binding context for this operation.

pvReserved

flags

A value of type DWORD that specifies one of the following flags.

0x00 (0x00)

Download the component if the version specified by dwFileVersionMS and dwFileVersionLS is more recent then the currently installed version.

0x01 (0x01)

Download the component regardless of the currently installed version.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements