RasGetEapConnectionData

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

DWORD RasGetEapConnectionData(
  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
  [out] 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, RasGetEapConnectionData will return ERROR_BUFFER_TOO_SMALL, and the pdwSizeofEapData parameter will contain the required size.

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

  If the buffer specified by the pbEapData parameter is not large enough, pdwSizeofEapData receives, on output, the required size.

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.

Requirements

See Also

Other Resources

FormatMessage
Extensible Authentication Protocol