Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method obtains the priority for the bind operation when it is called by an asynchronous moniker.

Syntax 

HRESULT GetPriority(
  LONG* 
pnPriority
);

Parameters

pnPriority

[out] 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 more information, see the Microsoft Win32 documentation for SetThreadPriorityand GetThreadPriority.

Return Value

Returns S_OK if this is successful or E_INVALIDARG if the pnPriorityparameter is invalid.

Remarks

The moniker calls this method, typically before starting the bind operation, to obtain the priority for the bind operation. This method can be called during the bind operation if the moniker has to make new priority decisions.

The moniker can use pnPriorityto set the priority of a thread associated with a bind operation, but more typically it will interpret the priority to perform its own scheduling among multiple bind operations. Notice 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::BindToStorageor IMoniker::BindToObject.

Applications that implement the IBindStatusCallbackinterface can return E_UNIMPL or S_OK if they are not interested in receiving this notification.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also