RasGetEapUserDataA 函数 (ras.h)
使用 RasGetEapUserData 函数检索用户特定的可扩展身份验证协议 (EAP) 指定电话簿条目的信息。
语法
DWORD RasGetEapUserDataA(
[in] HANDLE hToken,
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[out] BYTE *pbEapData,
[in, out] DWORD *pdwSizeofEapData
);
参数
[in] hToken
表示要检索数据的用户的主访问令牌或模拟访问令牌的句柄。 如果从已在用户上下文中运行的进程调用函数，则此参数可以为 NULL 。
[in] pszPhonebook
指向以 null 结尾的字符串的指针，该字符串指定电话簿 (PBK) 文件的完整路径。 如果此参数为 NULL，则该函数使用系统电话簿。
[in] pszEntry
指向以 null 结尾的字符串的指针，该字符串指定现有条目名称。
[out] pbEapData
指向接收用户检索到的 EAP 数据的缓冲区的指针。 调用方应为此缓冲区分配内存。 如果缓冲区不够大， RasGetEapUserData 将返回 ERROR_BUFFER_TOO_SMALL， 并且 pdwSizeofEapData 参数包含所需的大小。
[in, out] pdwSizeofEapData
指向 DWORD 变量的指针，该变量在输入时指定 pbEapData 参数指向的缓冲区的大小。
如果 pbEapData 参数指定的缓冲区不够大， 则 pdwSizeofEapData 会在输出时接收所需的大小。
返回值
如果函数成功，则返回值 ERROR_SUCCESS。
如果函数失败，则返回值为以下错误代码之一，或者来自 路由和远程访问错误代码 或 Winerror.h 的值。
| 值 | 含义 |
|---|---|
|
pdwSizeofEapData 参数为 NULL。 |
|
pbEapData 指向的缓冲区太小，无法接收数据。 pdwSizeofEapData 包含所需的大小。 |
|
RasGetEapUserData 无法打开指定的电话簿文件。 |
|
RasGetEapUserData 在电话簿中找不到指定的条目。 |
|
使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。 |
注解
注意
ras.h 标头将 RasGetEapUserData 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | ras.h |
| Library | Rasapi32.lib |
| DLL | Rasapi32.dll |