RasGetEapUserData

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)