RasSetAutodialAddressA 関数 (ras.h)

[アーティクル]
11/20/2024

RasSetAutodialAddress 関数は、AutoDial マッピングデータベースにアドレスを追加できます。または、関数は、データベース内の既存のアドレスに関連付けられているデータを削除または変更できます。

構文

DWORD RasSetAutodialAddressA(
  [in] LPCSTR              unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYA unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

パラメーター

[in] unnamedParam1

追加、削除、または変更するアドレスを指定する null-terminated 文字列へのポインター。このアドレスには、IP アドレス、インターネットホスト名 ("www.microsoft.com")、または NetBIOS 名 ("products1") を指定できます。

このパラメーターが NULL場合、関数は既定のインターネット接続を設定します (「解説」を参照)。このパラメーターが長さ 0 の文字列を指している場合、関数は既定のインターネット接続を削除します。

[in] unnamedParam2

引っ込み思案;は 0 にする必要があります。

[in] unnamedParam3

lpszAddress アドレスに関連付けられる 1 つ以上の RASAUTODIALENTRY 構造体の配列へのポインター。 lpAutoDialEntries が NULL 、dwcbAutoDialEntries が 0 の場合、rasSetAutodialAddress は、lpszAddress に関連付けられているすべての構造体をマッピングデータベースから削除します。

[in] unnamedParam4

lpAutoDialEntries バッファーのサイズをバイト単位で指定します。

[in] unnamedParam5

lpAutoDialEntries バッファー内の RASAUTODIALENTRY 構造体の数を指定します。

戻り値

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

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

価値	意味
ERROR_INVALID_SIZE	RASAUTODIALENTRY 構造体の dwSize メンバーが無効な値です。
ERROR_INVALID_PARAMETER	lpszAddress パラメーターは NULLです。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	lpAutoDialEntries に指定接続名が存在しません。

備考

自動ダイヤルマッピングデータベース内のアドレスには、RASAUTODIALENTRY エントリ関連付けられた任意の数を含めることができます。各エントリは、特定の TAPI ダイヤルの場所の自動ダイヤル情報を指定します。

lpszAddress パラメーターで指定されたアドレスがデータベース内の既存のアドレスであり、lpAutoDialEntries パラメーターが NULLされていない場合、RasSetAutodialAddress 関数は、アドレスに関連付けられている AutoDial エントリのセットを変更します。 lpAutoDialEntries 配列内のエントリで、アドレスに既にエントリがあるダイヤル位置が指定されている場合、関数は既存のエントリを新しいエントリに置き換えます。それ以外の場合、この関数は、lpAutoDialEntries エントリをアドレスのエントリのセットに追加します。

lpszAddress アドレスがデータベースに存在する場合、lpAutoDialEntries nullがされ、lpAutoDialEntries が 0 、RasSetAutodialAddress はデータベースからアドレスを削除します。

lpszAddress アドレスがデータベースに存在しない場合、RasSetAutodialAddress は、そのアドレスをデータベースに追加します。 lpAutoDialEntries パラメーターは、新しいアドレスに関連付ける AutoDial エントリを指定します。

RAS は、ローカルコンピューターへのグローバルな既定のインターネット接続をサポートし、各ユーザーの既定のインターネット接続をサポートします。

lpszAddress パラメーターが NULLされ、lpAutoDialEntries パラメーターで 1 つのエントリを持つ接続名が指定されている場合、RasSetAutodialAddress は接続を既定のインターネット接続として設定。 lpAutoDialEntries で指定接続名は既に存在している必要があります。そうでない場合は、ERROR_CANNOT_FIND_PHONEBOOK_ENTRY が返されます。

lpszAddress パラメーターが長さ 0 の文字列で、lpAutoDialEntries パラメーターが 1 つのエントリを持つ空の接続名を指定する場合、RasSetAutodialAddress 既定のインターネット接続が削除されます。

ドメイン以外のクライアントコンピューターでは、ユーザーが既定のインターネット接続として接続を設定し、RASAUTODIALENTRY 構造体の szEntry メンバーで "for-all-users" 接続を指定する場合、既定のインターネット接続はローカルコンピューターでグローバルに設定されます。それ以外の場合は、コンピューターのユーザーごとに既定のインターネット接続が個別に設定されます。

1 つが "for-all-users" 接続として構成され、もう一方が "for-me-only" 接続として構成されている場合は、同じ名前の 2 つの接続を持つことができます。 lpAutoDialEntries パラメーターで、グローバル接続とユーザーごとの接続の両方に対応する接続名を指定すると、ユーザーごとの接続が設定されます。

手記

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

必要条件

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

次の方法で共有

RasSetAutodialAddressA 関数 (ras.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース