EapPeerCredentialsXml2Blob function (eapmethodpeerapis.h)

Converts XML into the configuration BLOB. The XML based credentials can come from group policy or from a system administrator.

Syntax

DWORD EapPeerCredentialsXml2Blob(
  [in]  DWORD            dwFlags,
  [in]  EAP_METHOD_TYPE  eapMethodType,
  [in]  IXMLDOMDocument2 *pCredentialsDoc,
  [in]  const BYTE       *pConfigIn,
  [in]  DWORD            dwSizeOfConfigIn,
  [out] BYTE             **ppCredentialsOut,
  [out] DWORD            *pdwSizeOfCredentialsOut,
  [out] EAP_ERROR        **ppEapError
);

Parameters

[in] dwFlags

Not used. Set to 0.

[in] eapMethodType

An EAP_METHOD_TYPE structure that contains vendor and author information about the EAP method used for authenticating the connection.

[in] pCredentialsDoc

A pointer to an XML node that contains credentials, which are either user or machine credentials depending on the configuration passed in. The XML document is created with the EapHostUserCredentials Schema.

[in] pConfigIn

A pointer to a byte buffer that contains a configuration BLOB for which the credentials are configured. The buffer is of size dwSizeofConfigIn.

[in] dwSizeOfConfigIn

The size, in bytes, of the buffer pointed to by pConfigIn.

[out] ppCredentialsOut

A pointer to the byte buffer that receives the credentials BLOB buffer generated by the input XML. The buffer can is of size pdwSizeofCredentialsOut. After consuming the data, this memory must be freed by calling EapPeerFreeMemory.

[out] pdwSizeOfCredentialsOut

The size, in bytes, of the buffer pointed to by ppCredentialsOut.

[out] ppEapError

A pointer to the address of an EAP_ERROR structure that contains any errors raised by EAPHost during the execution of this function call. After consuming the error data, this memory must be freed by calling EapPeerFreeErrorMemory.

Return value

None

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	eapmethodpeerapis.h

See also

EAPHost Peer Method Configuration Functions