次の方法で共有

RasRenameEntryA 関数 (ras.h)

  • [アーティクル]

RasRenameEntry 関数は、電話帳のエントリの名前を変更します。

構文

DWORD RasRenameEntryA(
  [in] LPCSTR unnamedParam1,
  [in] LPCSTR unnamedParam2,
  [in] LPCSTR unnamedParam3
);

パラメーター

[in] unnamedParam1

電話帳 (PBK) ファイルの完全なパスとファイル名を指定する null で終わる文字列へのポインター。 このパラメーターが NULL場合、関数は現在の既定の電話帳ファイルを使用します。 既定の電話帳ファイルは、ダイヤルアップ ネットワーク] ダイアログ ボックスの [ユーザー設定 プロパティ シートでユーザーが選択したものです。

Windows Me/98/95: このパラメーターは常に NULLする必要があります。 ダイヤルアップ ネットワークでは、電話帳ファイルではなく、レジストリに電話帳エントリが格納されます。

[in] unnamedParam2

既存のエントリ名を指定する null で終わる文字列へのポインター。

[in] unnamedParam3

新しいエントリ名を指定する null で終わる文字列へのポインター。 RasRenameEntry呼び出す前に、RasValidateEntryName 関数を呼び出して、新しいエントリ名を検証します。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかのエラー コード、または Routing と Remote Access Error Codes または Winerror.h からの値です。

価値 意味
ERROR_NOT_ENOUGH_MEMORY
 この関数は、操作を完了するのに十分なメモリを割り当てませんでした。
ERROR_INVALID_NAME
 lpszNewEntry 名が無効です。
ERROR_ALREADY_EXISTS
 lpszNewEntry 名のエントリが既に存在します。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
 電話帳のエントリが存在しません。

備考

RasRenameEntry 関数を使用すると、ダイヤルアップ ネットワーク ユーザー インターフェイスでは受け入れられないエントリ名を使用できます。 RasRenameEntry で指定されたエントリ名は、次の条件に従う任意の文字列で構成できます。

  1. 文字列の長さをRAS_MaxEntryNameより大きくすることはできません (Ras.h で定義されています)。
  2. 文字列全体をスペースまたはタブ文字で構成することはできません。
  3. 文字列の最初の文字をピリオド文字 (".") にすることはできません。
次のコード サンプルでは、pszOldName で指定された名前を pszNewNameで指定された新しい名前 電話帳エントリの名前を変更します。 
#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include <tchar.h>

DWORD main (){

    DWORD dwErr = ERROR_SUCCESS;
    LPCTSTR pszOldName = L"RAS Connection 1\0";
    LPCTSTR pszNewName = L"RAS Connection 2\0";

    dwErr = RasValidateEntryName(NULL, pszNewName);
    if (ERROR_SUCCESS != dwErr)
    {
        printf("RasValidateEntryName failed: Error = %d\n", dwErr);
        return dwErr;
    }

    dwErr = RasRenameEntry(NULL, pszOldName, pszNewName);
    if (ERROR_SUCCESS != dwErr)
    {
        printf("RasRenameEntry failed: Error = %d\n", dwErr);
        return dwErr;
    }

    printf("Successfully renamed entry '%s' to '%s'\n", pszOldName, pszNewName);

    return 0;
}

手記

ras.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RasRenameEntry を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ras.h
ライブラリ Rasapi32.lib
DLL Rasapi32.dll

関連項目

RasValidateEntryName

リモート アクセス サービス (RAS) の概要

リモート アクセス サービス関数 の