IBindStatusCallback::GetPriority method

Gets the priority for the bind operation when it is called by an asynchronous moniker.


HRESULT GetPriority(
  [out] long *pnPriority


pnPriority [out]

The address of a long integer value that indicates the priority of this bind operation. Priorities can be any of the constants defined for prioritizing threads. For details, see the Win32 documentation for SetThreadPriority and GetThreadPriority.

Return value

Returns S_OK if successful, or E_INVALIDARG if the pnPriority parameter is invalid.


The moniker calls this method prior to initiating the bind operation, to get the priority for the bind operation. This method can be called at any time during the bind operation, if the moniker has to make new priority decisions.

The moniker can use pnPriority to set the priority of a thread that is associated with a bind operation. Typically, it interprets the priority to perform its own scheduling among multiple bind operations. Note that the policy for determining priority for URL monikers is not yet determined. The moniker must not change the priority of the thread that is used to call IMoniker::BindToStorage or IMoniker::BindToObject.

Applications that implement the IBindStatusCallback interface can return E_UNIMPL or S_OK, if they don't want to receive this notification.


Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003


Internet Explorer 4.0



See also