Contents Index Topic Contents | ||
Previous Topic: IBindStatusCallback::GetBindInfo Next Topic: IBindStatusCallback::OnDataAvailable |
IBindStatusCallback::GetPriority
HRESULT GetPriority( [out] LONG *pnPriority );Obtains the priority for the bind operation when called by an asynchronous moniker.
- Returns S_OK if successful, or E_INVALIDARG if the pnPriority parameter is invalid.
- pnPriority
- Address of a LONG value indicating 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.
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 pnPriority to set the 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.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.