Partager via


2.2.1.2.87 MPR_CREDENTIALSEX_1

The MPR_CREDENTIALSEX_1 structure is used to contain extended credentials information (other than username/password), such as the information used by Extensible Authentication Protocols (EAPs) or a preshared key based on the level being passed in by the methods that use this structure. This structure is used in RRouterInterfaceSetCredentialsEx (section 3.1.4.41) and RRouterInterfaceGetCredentialsEx (section 3.1.4.42). If a preshared key is being used dwSsize MUST be less than 257. Note that the preshared key here is used to specify the credential for the connection endpoint on the RRAS server. The other end of the connection endpoint MUST be configured with the same preshared key in order for the connection to be successful.  

 typedef struct _MPR_CREDENTIALSEX_1 {
   DWORD dwSize;
   DWORD dwOffset;
   BYTE bData[1];
 } MPR_CREDENTIALSEX_1,
  *PMPR_CREDENTIALSEX_1;

dwSize: Specifies the size of the data pointed to by the bData member. If dwSize is zero (0) in a call to RRouterInterfaceSetCredentialsEx and the key is a preshared key, the key is deleted.

dwOffset: Offset where the data starts in the structure.

bData: Pointer to the credential information. Note that bData[1] is only a placeholder and the actual data of size dwSize is stored at the end of the structure. The actual value stored here can be either a preshared key or the EAP information EAPTLS_USER_PROPERTIES (section 2.2.1.2.128)