IBindStatusCallback::GetPriority method
Gets the priority for the bind operation when it is called by an asynchronous moniker.
Syntax
HRESULT GetPriority(
[out] long *pnPriority
);
Parameters
- 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.
Remarks
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.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows Server 2003 |
Product |
Internet Explorer 4.0 |
DLL |
Urlmon.dll |