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 function changes the priority of the current connection.

Syntax 

HRESULT WINAPI ConnMgrSetConnectionPriority(
  HANDLE   
hConnection,
  DWORD
dwPriority
);

Parameters

hConnection

[in] Handle to the connection, returned from ConnMgrEstablishConnection.

dwPriority

[in] A new priority specified by one of the Connection Manager priority constants. For details, see Connection Manager Priority Constants.

Return Values

Returns S_OKif successful or returns an error code if the function call failed.

Remarks

Connection Manager arbitrates among multiple connections, satisfying as many as possible at a time but giving preference to higher priority connection types.

This function is useful if you want to change the priority of a specific task after it starts running. For example, you can prevent a connection from being interrupted or halted if you increase the priority of that connection after it starts running.

Requirements

Header connmgr.h
Library cellcore.lib
Windows Embedded CE Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009
Windows Mobile Windows Mobile Version 5.0 and later

See Also