RasSetEapConnectionData (Windows Embedded CE 6.0)

1/6/2010

This function stores connection-specific Extensible Authentication Protocol (EAP) information.

Syntax

DWORD RasSetEapConnectionData (
  LPCTSTR pszPhonebook,
  LPCTSTR pszEntry, 
  PBYTE pbEapData, 
  PDWORD pdwSizeofEapData
);

pszPhonebook
[in] This parameter is ignored and should be set to NULL. Dial-up networking stores phone-book entries in the registry rather than in a phone-book file.

pszEntry
[in] Pointer to a null-terminated string that specifies the full path of the phone-book (PBK) file. If this parameter is NULL, the function will use the system phone book.

pbEapData
[in] Pointer to a buffer that receives the retrieved EAP data for the user. The caller should allocate the memory for this buffer. If the buffer is not large enough, RasSetEapConnectionData will return ERROR_BUFFER_TOO_SMALL, and the pdwSizeofEapData parameter will contain the required size.

pdwSizeofEapData
[in] Pointer to a DWORD variable that specifies the size of the buffer pointed to by the pbEapData parameter.

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is one of the following error codes.

Value	Description
E_INVALIDARG	The pdwSizeofEapData parameter is NULL.
ERROR_BUFFER_TOO_SMALL	The buffer pointed to by pbEapData is too small to receive the data. The pdwSizeofEapData contains the required size.
ERROR_CANNOT_OPEN_PHONEBOOK	RasGetEapConnectionData was unable to open the specified phone-book file.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasGetEapConnectionData was unable to find the specified entry in the phone book.
Other	Use FormatMessage to retrieve the system error message that corresponds to the error code returned.