DWORD RasGetEapUserData(
_In_ HANDLE hToken,
_In_ LPCTSTR pszPhonebook,
_In_ LPCTSTR pszEntry,
_Out_ BYTE *pbEapData,
_Inout_ DWORD *pdwSizeofEapData
);
说明
该函数用于获取指定的电话簿条目的用户特定的可扩展认证协议(EAP)信息。
参数
hToken [in]
代表用户进行存储数据的一个原始或模拟访问令牌(Token)。函数运行于用户上下文中时该参数可以为NULL。
pszPhonebook [in]
指向包含完整路径的电话簿文件。该字符串为NULL时将使用系统电话簿。
pszEntry [in]
指定电话簿条目名称。
pbEapData [out]
指向用户EAP数据缓冲。调用前应分配内存。如果缓冲长度不足,则该函数返回ERROR_BUFFER_TOO_SMALL,同时pdwSizeofEapData指向的变量返回实际需要的字节数。
pdwSizeofEapData [in, out]
指向一个DWORD变量,用于指定pbEapData指向的缓冲长度。当缓冲长度不足时通过此变量返回实际需要的字节数。
返回值
成功时返回ERROR_SUCCESS。
失败时返回以下列表中的值之一或来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。
值 | 含义 |
---|---|
E_INVALIDARG | pdwSizeofEapData参数为NULL。 |
ERROR_BUFFER_TOO_SMALL | pbEapData参数指向的缓冲长度不足。 |
ERROR_CANNOT_OPEN_PHONEBOOK | RasSetEapUserData函数无法打开指定的电话簿文件。 |
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY | RasSetEapUserData函数找不到指定的电话簿条目。 |
Other | 使用FormatMessage函数获取系统错误描述。 |
系统支持
客户端最小支持 | Windows 2000专业版 |
---|---|
服务端最小支持 | Windows 2000 Server |
Header | Ras.h |
Library | Rasapi32.lib |
DLL | Rasapi32.dll |
Unicode和ANSI名称 | RasGetEapUserDataW(Unicode)和RasGetEapUserDataA(ANSI) |