RasGetCustomAuthData

Use the RasGetCustomAuthData function to retrieve connection-specific authentication information. This information is not specific to a particular user.

DWORD RasGetCustomAuthData (
  LPCWSTR pszPhonebook,              // path to phone book to use
  LPCWSTR pszEntry,                  // name of entry in phone book
  BYTE * pbCustomAuthData,          // buffer to receive data
  DWORD * pdwSizeofCustomAuthData    // size of buffer
);

Parameters

pszPhonebook

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

pszEntry

Pointer to a null-terminated string containing an existing entry name.

pbCustomAuthData

Pointer to a buffer to receive the authentication data. The caller should allocate the memory for this buffer. If the buffer is not large enough, RasGetCustomAuthData will return ERROR_BUFFER_TOO_SMALL, and the pdwSizeofEapData parameter will contain the required size.

pdwSizeofCustomAuthData

Pointer to a DWORD variable that contains the size of the buffer pointed to by the pbCustomAuthData parameter.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Ras.h.
  Library: Use Rasapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

RasGetEapUserData, RasSetCustomAuthData