共用方式為

RasValidateEntryNameA 函式 （ras.h）

  • 發行項

RasValidateEntryName 函式會驗證連接專案名稱的格式。 名稱必須至少包含一個非空格英數位元。

語法

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

參數

[in] unnamedParam1

Null 終止字串的指標，指定電話簿檔案的完整路徑和檔名。 如果此參數 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 標頭會根據 UNICODE 預處理器常數的定義，將 RasValidateEntryName 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 ras.h
連結庫 Rasapi32.lib
DLL Rasapi32.dll

另請參閱

RasCreatePhonebookEntry

RasGetEntryProperties

遠端存取服務 （RAS） 概觀

遠端訪問服務函式