[New - Windows NT]
RasSetEntryProperties功能更改电话簿中条目的连接信息或创建新的电话簿条目。
DWORD RasSetEntryProperties(af
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPTSTR 【lpszEntr】y, | //指向条目名称的指针 |
LPRASENTRY 【lpRasEntry】, | //包含条目信息的缓冲区 |
DWORD【dwEntryInfoSize】, | //大小(以字节为单位)的【lpRasEntry】缓冲区 |
LPBYTE 【lpbDeviceInfo】, | //包含特定于设备的配置信息的缓冲区 |
DWORD 【dwDeviceInfoSize】 | //大小(以字节为单位)的【lpbDeviceInfo】缓冲区 |
); |
参数
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
【lpszEntry】
指向包含条目名称的以null结尾的字符串。
如果条目名称与现有条目匹配,RasSetEntryProperties将修改该条目的属性。
如果条目名称与现有条目不匹配,RasSetEntryProperties将创建一个新的电话簿条目。对于新条目,请调用RasSetEntryProperties以在RasSetEntryProperties之前验证条目名称。
【lpRasEntry】
指向RASENTRY结构的指针,其中包含与【lpszEntry】参数指定的电话簿条目相关联的新连接数据。
该结构后面可以是一个空值终止的备用电话号码字符串数组。最后一个字符串由两个连续的空字符终止。RASENTRY结构的dwAlternateOffset成员包含与第一个字符串的偏移量。
【dwEntryInfoSize】
指定由【lpRasEntry】参数指定的缓冲区的大小(以字节为单位)。
【lpbDeviceInfo】
指向包含特定于设备的配置信息的缓冲区。这是不透明的TAPI设备配置信息。有关TAPI设备配置的更多信息,请参阅Win32 Telephony(TAPI)程序员参考。
【dwDeviceInfoSize】
指定【lpbDeviceInfo】缓冲区的大小(以字节为单位)。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值可以是以下错误代码之一。
值 | 含义 |
ERROR_BUFFER_INVALID | 【lpRasEntry】指定的地址或缓冲区无效。 |
ERROR_CANNOT_OPEN_PHONEBOOK | 电话簿已损坏或丢失组件。 |
也可以看看
RASENTRY, RasCreatePhonebookEntry, RasGetEntryProperties, RasValidateEntryName