RasEnumEntries功能列出了远程访问电话簿中的所有条目名称。
DWORD RasEnumEntries(
LPTSTR 【保留的】, | // reserved,必须为NULL |
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPRASENTRYNAME 【// buffer to receive phone-book entries】, | //缓冲区接收电话簿条目 |
LPDWORD 【LPCB】, | //以字节为单位的缓冲区大小 |
LPDWORD 【// number of entries written to buffer】 | //写入缓冲区的条目数 |
); |
参数
【保留的】
Reserved; must be NULL.
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
Windows 95:此参数被忽略。拨号网络将电话簿条目存储在注册表中,而不是电话簿文件中。
【// buffer to receive phone-book entries】
指向接收RASENTRYNAME结构数组的缓冲区,每个电话簿条目一个。在调用该函数之前,应用程序必须将缓冲区中第一个RASENTRYNAME结构的的dwSize成员设置为sizeof(RASENTRYNAME),以便标识要传递的结构的版本。
【LPCB】
指向包含由【// buffer to receive phone-book entries】指定的缓冲区的大小(以字节为单位)的变量。返回时,该函数将此变量设置为成功完成调用所需的字节数。
【// number of entries written to buffer】
指向变量,如果成功,函数将设置为写入【// buffer to receive phone-book entries】指定的缓冲区的电话簿条目数。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是RAS头文件中列出的非零错误值,或ERROR_BUFFER_TOO_SMALL或ERROR_NOT_ENOUGH_MEMORY中的一个。
也可以看看