[New - Windows NT]
RasEntryDlg功能显示允许用户操作电话簿条目的模态属性表。如果编辑或复制现有的电话簿条目,该函数将显示电话簿条目属性表。当用户关闭属性表时,RasEntryDlg函数返回。
BOOL RasEntryDlg(
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPTSTR 【lpszEntry】, | //指向要编辑,复制或创建的电话簿条目的名称 |
LPRASENTRYDLG 【lpinfoit】 | //指向包含其他参数的结构的指针 |
); |
参数
【lpszPhonebook】
指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
【lpszEntry】
指向一个空值终止的字符串,其中包含要编辑,复制或创建的电话簿条目的名称。
如果您正在编辑或复制条目,则此参数是现有电话簿条目的名称。如果要复制条目,请在RASENTRYDLG结构的dwFlags中成员中设置RASEDFLAG_CloneEntry标志。
如果要创建条目,则该参数是用户可以更改的默认新条目名称。如果此参数为NULL,则该函数提供默认名称。如果要创建条目,请在RASENTRYDLG结构的dwFlags中成员中设置RASEDFLAG_NewEntry标志。
【lpinfoit】
指向RASENTRYDLG结构的指针,其中包含附加的输入和输出参数。输入时,此结构的的dwSize成员必须指定的sizeof(RASENTRYDLG)。使用dwFlags中成员来表示是创建,编辑还是复制条目。如果发生错误,dwError成员返回错误代码;否则返回0。
返回值
如果用户创建,复制或编辑电话簿条目,则返回值为非零值。
如果发生错误,或者用户取消操作,返回值为零。如果发生错误,dwError结构的dwError成员返回非零系统错误代码或RAS错误代码。
备注
RasCreatePhonebookEntry和RasEditPhonebookEntry函数调用RasEntryDlg函数。
也可以看看