IBindStatusCallback::GetPriorityIBindStatusCallback::GetPriority*
*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.

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.


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.