CmSetRequirements (Compact 2013)

3/26/2014

This function associates connection requirements with a session.

Syntax

CM_RESULT CmSetRequirements(
    __in CM_SESSION_HANDLE hSession,
    __in_bcount(cbRequirements) const CM_REQUIREMENTS* pRequirements,
    __in DWORD cbRequirements);

Parameters

• hSession
  [in] A pointer to a CM_SESSION_HANDLE.

• pRequirements
  [in] A pointer to a set of CM_REQUIREMENTS structures.

• cbRequirements
  [in] The number of CM_REQUIREMENTS structures in the pRequirements list.

Return Value

Value	Description
CMRE_SUCCESS	The operation completed successfully.
CMRE_INVALID_SESSION	The hSession is not valid.
CMRE_OUT_OF_MEMORY	Memory can not be allocated to complete the operation.
CMRE_INVALID_VERSION	The Connection Manager Common Constants of one or more of the pRequirements structures is not supported.
CMRE_INVALID_REQUIREMENTS	The cbRequirements parameter is invalid.

Remarks

The connection requirements associated with the session are used to select a connection.

Requirements

Header	cmnet.h
Library	cmnet.lib

See Also

Reference

Connection Manager Connectivity Functions
Connection Manager Common Constants
CM_REQUIREMENTS
CM_SESSION_HANDLE