RasSetEapConnectionData
A version of this page is also available for
4/8/2010
This function stores connection-specific Extensible Authentication Protocol (EAP) information.
Syntax
DWORD RasSetEapConnectionData (
LPCTSTR pszPhonebook,
LPCTSTR pszEntry,
PBYTE pbEapData,
PDWORD pdwSizeofEapData
);
Parameters
- 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.
Return Value
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. |
Requirements
| Header | ras.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |