通过

RasValidateEntryNameA 函数 (ras.h)

  • 项目

RasValidateEntryName 函数验证连接条目名称的格式。 名称必须至少包含一个非空格字母数字字符。

语法

DWORD RasValidateEntryNameA(
  [in] LPCSTR unnamedParam1,
  [in] LPCSTR unnamedParam2
);

parameters

[in] unnamedParam1

指向以 null 结尾的字符串的指针，指定电话簿 (PBK) 文件的完整路径和文件名。 如果此参数为 NULL，则该函数使用当前默认电话簿文件。

Windows Me/98/95： 此参数应始终为 NULL。 拨号网络将电话簿条目存储在注册表中，而不是存储在电话簿文件中。

[in] unnamedParam2

指向以 null 结尾的字符串的指针，该字符串指定条目名称。

条目名称中不允许使用以下字符。

字符 含义
|
 垂直条
>
 大于符号
<
 小于符号
?
问号
*
 星号
\
 向后斜杠
/
 正斜杠
:
结肠
 

Windows 2000 或更高版本： 条目名称不能以句点 (“开头。) 。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值为以下错误代码之一，或者来自 路由和远程访问错误代码 或 Winerror.h 的值。

值 含义
ERROR_ALREADY_EXISTS
 指定的电话簿中已存在条目名称。
ERROR_CANNOT_FIND_PHONEBOOK
 指定的电话簿不存在。
ERROR_INVALID_NAME
 指定条目名称的格式无效。

注解

以下示例代码验证变量 lpszEntry 指定的电话簿条目。

#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include <tchar.h>

DWORD __cdecl wmain(){

    LPTSTR lpszEntry = L"EntryName\0";

    DWORD nRet = RasValidateEntryName(NULL, lpszEntry);

    switch (nRet)
    {
        case ERROR_SUCCESS:
            printf("Entry name: %s is valid but doesn't exist in the default phone book\n", lpszEntry);
            break;
        case ERROR_INVALID_NAME:
            printf("Entry name: %s is invalid\n", lpszEntry);
            break;
        case ERROR_ALREADY_EXISTS:
            printf("Entry name: %s already exists in the default phone book\n", lpszEntry);
            break;
        default:
            printf("RasValidateEntryName failed: Error = %d\n", nRet);
            break;
    }
}

注意

ras.h 标头将 RasValidateEntryName 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ras.h
Library Rasapi32.lib
DLL Rasapi32.dll

请参阅

RasCreatePhonebookEntry

RasGetEntryProperties

远程访问服务 (RAS) 概述

远程访问服务功能