EapHostPeerConfigXml2Blob function (eaphostpeerconfigapis.h)

Converts XML into the configuration BLOB. When the supplicant starts authentication or calls EapHostPeerInvokeConfigUI, the supplicant calls EapHostPeerConfigXml2Blob to convert the XML configuration into a BLOB.

The XML data to be converted could originate from a EapHostPeerConfigBlob2Xml call, or the data could originate from a XML created by a system administrator or other XML author.

Syntax

DWORD EapHostPeerConfigXml2Blob(
  [in]  DWORD           dwFlags,
  [in]  IXMLDOMNode     *pConfigDoc,
  [out] DWORD           *pdwSizeOfConfigOut,
  [out] BYTE            **ppConfigOut,
  [out] EAP_METHOD_TYPE *pEapMethodType,
  [out] EAP_ERROR       **ppEapError
);

Parameters

[in] dwFlags

Not used. Set to 0.

[in] pConfigDoc

Sends a pointer to the XML configuration to be converted.

[out] pdwSizeOfConfigOut

A pointer to the size, in bytes, of the configuration BLOB.

[out] ppConfigOut

A pointer to a pointer to a byte buffer that contains the configuration data converted from XML. The configuration data is created inside EapHostConfig Schema element. The buffer is of size pdwSizeOfConfigOut. After consuming the data, this memory must be freed by calling EapHostPeerFreeMemory.

[out] pEapMethodType

A pointer to an EAP_METHOD_TYPE structure referred to in the XML document.

[out] ppEapError

A pointer a pointer to 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 EapHostPeerFreeErrorMemory.

Return value

None

Requirements

See also

EAPHost Supplicant Configuration Functions

EapHostPeerConfigXml2Blob

EapHostPeerGetResult

EapHostPeerInvokeConfigUI