RasSetSubEntryProperties

【勇芳软件工作室】汉化HomePreviousNext

[New - Windows NT]

RasSetSubEntryProperties功能创建新的子条目或修改指定电话簿条目的现有子条目。

DWORD RasSetSubEntryProperties(af

LPTSTR 【lpszPhonebook】,//指向电话簿文件的完整路径和文件名//指向电话簿文件的完整路径和文件名
LPTSTR 【lpszEntry】,//指向条目名称的指针//指向条目名称的指针
DWORD 【dwSubEntry】,//子条目的索引//
LPRASSUBENTRY 【lpRasSubEntry】,//指向包含有关子条目信息的结构体的指针//
DWORD 【dwcb】//结构的大小(以字节为单位)//
);  

参数

【lpszPhonebook】

Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。

【lpszEntry】

指向一个以空字符结尾的字符串,其中包含电话簿中现有条目的名称。

【dwSubEntry】

指定子条目的基于索引的索引。如果索引与现有的子条目索引匹配,该函数将更改该子条目的属性。如果索引与现有索引不匹配,该函数将创建一个新的子条目。

【lpRasSubEntry】

指向包含子条目数据的RASSUBENTRY结构。

该结构后面可以是一个空值终止的备用电话号码字符串数组。最后一个字符串由两个连续的空字符终止。RASSUBENTRY结构的dwAlternateOffset成员包含与第一个字符串的偏移量。

【dwcb】

指定【lpRasSubEntry】缓冲区的大小(以字节为单位)。

返回值

如果函数成功,返回值为零。

如果函数失败,则返回值可以是以下错误代码之一。

含义
ERROR_BUFFER_INVALID【lpRasEntry】指定的地址或缓冲区无效。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY电话簿条目不存在。
ERROR_CANNOT_OPEN_PHONEBOOK电话簿已损坏或丢失组件。
ERROR_INVALID_PARAMETER该函数调用无效参数。

备注

RAS电话簿条目可以具有零个或多个子条目,每个子条目最少由设备和电话号码组成。具有多个子条目的电话簿条目可以配置为在拨打条目时拨打第一个可用子条目或所有子条目。

使用RasGetEntryProperties功能检索包含电话簿条目子条目信息的RASENTRY结构。dwSubEntries成员表示子条目数,dwDialMode成员表示拨号配置。

也可以看看

RasGetEntryProperties, RASENTRY, RASSUBENTRY