rasSetCustomAuthDataA 函数 (ras.h)
使用 RasSetCustomAuthData 函数设置特定于连接的身份验证信息。 此信息不应特定于特定用户。
语法
DWORD RasSetCustomAuthDataA(
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[in] BYTE *pbCustomAuthData,
[in] DWORD dwSizeofCustomAuthData
);
参数
[in] pszPhonebook
指向以 null 结尾的字符串的指针,该字符串指定电话簿 (PBK) 文件的完整路径。 如果此参数为 NULL,则该函数使用系统电话簿。
[in] pszEntry
指向以 null 结尾的字符串的指针,该字符串指定现有条目名称。
[in] pbCustomAuthData
指向指定新身份验证数据的缓冲区的指针。
[in] dwSizeofCustomAuthData
指定 pbCustomAuthData 参数指向的数据的大小。
返回值
如果函数成功,则返回值 ERROR_SUCCESS。
如果函数失败,则返回值为以下错误代码之一或 路由和远程访问错误代码 或 Winerror.h 中的值。
值 | 含义 |
---|---|
|
dwSizeofCustomAuthData 参数为零,或 pbCustomAuthData 参数为 NULL。 |
|
RasSetEapUserData 无法打开指定的电话簿文件。 |
|
RasSetEapUserData 在电话簿中找不到指定的条目。 |
|
使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。 |
注解
注意
ras.h 标头将 RasSetCustomAuthData 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ras.h |
Library | Rasapi32.lib |
DLL | Rasapi32.dll |