CreateStdProgressIndicator

[This is preliminary documentation and subject to change.]

Provides an implementation of the IBindStatusCallback interface that will display a progress dialog when passed to methods such as CoInstall, CoGetClassObjectFromURL, and CoCreateInstanceEx.

Note  CreateStdProgressIndicator is not fully implemented.

WINOLEAPI CreateStdProgressIndicator(
  HWND hwndParent,     //Window for parent of the progress dialog
  LPCOLESTR pszTitle,  //Caption for the dialog
  IBINDSTATUSCALLBACK *pibscCaller,  //IBSC to which calls are forwarded
  IBINDSTATUSCALLBACK **ppibsc  //Pointer used to pass activation APIs
);
 

Parameters

hwndParent

[in] Window to be used as the parent of the progress dialog. This parameter can be NULL, which will cause the dialog to be rooted on the desktop window.

pszTitle

[in] Caption to be used for the dialog.

pibscCaller

[in] An optional parameter, if the value for this parameter is not NULL, the progress indicator IBindStatusCallback forwards all calls to this IBindStatusCallback.

ppibsc

[in] An interface pointer that can be passed to asynchronous activation APIs.

Return Values

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

S_OK

The progress dialog helper object was created 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.