RasValidateEntryNameA 函式 (ras.h)

  • 發行項

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

語法

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

參數

[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 標頭會根據 UNICODE 預處理器常數的定義，將 RasValidateEntryName 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ras.h
程式庫 Rasapi32.lib
Dll Rasapi32.dll

另請參閱

RasCreatePhonebookEntry

RasGetEntryProperties

遠端存取服務 (RAS) 概觀

遠端存取服務函式