IBindStatusCallback::GetPriority

An asynchronous moniker calls this method to obtain the priority for the bind operation.

HRESULT GetPriority(
  LONG *pnPriority  //Pointer to priority value
);
 

Parameters

pnPriority
[out] Pointer a LONG value indicating the priority of this bind operation. Priorities may be any of the constants defined for prioritizing threads. See the Win32 documentation for SetThreadPriority and GetThreadPriority for details.

Return Values

S_OK
The operation was successful.
E_INVALIDARG
The pnPriority parameter is invalid.

Remarks

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

The moniker can use this value for setting the actual priority of a thread associated with a bind operation but more commonly it will interpret 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 used for calling IMoniker::BindToStorage or IMoniker::BindToObject.

Notes to Implementers

A client can return E_UNIMPL or S_OK if it is not interested in receiving this notification.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.