Platform SDK: RAS/Routing and RAS

RasSetCustomAuthData

Use the RasSetCustomAuthData function to set connection-specific authentication information. This information should not be specific to a particular user.

DWORD RasSetCustomAuthData (
  LPCWSTR pszPhonebook,             // path to phone book to use
  LPCWSTR pszEntry,                 // name of entry in phone book
  BYTE * pbCustomAuthData,          // pointer to data
  DWORD * dwSizeofCustomAuthData    // size of data
);

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 containing the new authentication data.
dwSizeofCustomAuthData: Size of the data 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.

Value	Meaning
E_INVALIDARG	The dwSizeofCustomAuthData parameter is zero, or the pbCustomAuthData parameter is NULL.
ERROR_CANNOT_OPEN_PHONEBOOK	RasSetEapUserData was unable to open the specified phone-book file.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasSetEapUserData 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

  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.

RasSetCustomAuthData

Parameters

Return Values

Requirements

See Also