CoInstall

[This is preliminary documentation and subject to change.]

Queries the Class Store Manager object and installs the package.

WINOLEAPI CoInstall(
  IBindCtx *pbc,         //Specifies the bind context
  DWORD dwFlags,         //Reserved
  uCLSSPEC *pClassSpec,  //Points to a uCLSSPEC structure
  QUERYCONTEXT *pQuery,  //Points to a QUERYCONTEXT structure
  LPWSTR *pszCodeBase  //Points to a default location for package installation
);
 

Parameters

pbc

[in] The bind context to use for downloading or installing component code. Register IBindStatusCallback in this bind context to receive callbacks during the download and installation process.

dwFlags

[in] Reserved, must be 0.

pClassSpec

[in] Specifies a pointer to a uCLSSPEC structure indicating the class spec (class identifier, file extension, or MIME type).

pQuery

[in] Specifies a pointer to a QUERYCONTEXT structure that provides information about the context into which the package is to be installed. Can be NULL, indicating that CoInstall will retrieve default values based on the operating system and thread/process locale.

pszCodeBase

[out] Specifies a pointer to a Unicode string, which indicates a default location from which the package can be installed. Used only if the package is not found in the class store.

Return Values

This method supports the standard return value E_OUTOFMEMORY, as well as the following:

S_OK

The download was completed successfully.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.