[New - Windows NT]
RasGetCredentials功能检索与指定的RAS电话簿条目关联的用户凭据。
// pointer to structure that receives credentials
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名的指针 |
LPTSTR 【lpszEntry】, | //指向电话簿条目的名称 |
LPRASCREDENTIALS 【//指向结构的指针,指定凭据】 | //指向接收凭据的结构的指针 |
); |
参数
【lpszPhonebook】
指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
【lpszEntry】
指向包含电话簿条目名称的以null结尾的字符串。
【//指向结构的指针,指定凭据】
指向RASCREDENTIALS结构的指针,可以接收与指定电话簿条目关联的用户凭据。在调用RasGetCredentials之前,将结构的的dwSize成员设置为sizeof(RASCREDENTIALS),并设置dwMask成员以指示要检索的凭据信息。当函数返回时,dwMask表示成功检索的成员。
返回值
如果函数成功返回值为零。
如果函数失败,则返回值可以是以下错误代码之一。
值 | 含义 |
ERROR_CANNOT_OPEN_PHONEBOOK | 指定的电话簿无法找到。 |
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY | 电话簿中不存在指定的条目。 |
ERROR_INVALID_PARAMETER | 【//指向结构的指针,指定凭据】参数为NULL。 |
ERROR_INVALID_SIZE | 的dwSize结构的的dwSize成员是无法识别的值。 |
备注
RasGetCredentials功能使用指定的电话簿条目或随后在电话簿条目的RasSetCredentials功能的呼叫中指定的凭据检索最后一个用户成功连接的凭据。
RasGetCredentials功能可检索为指定的电话簿条目安全存储的用户凭据。此函数是安全地检索与RAS电话簿条目关联的凭据的首选方法。RasGetCredentials取代RasGetEntryDialParams功能,这在以后的Windows NT版本中可能不受支持。
也可以看看