次の方法で共有

RasGetAutodialParamA 関数 (ras.h)

  • [アーティクル]

RasGetAutodialParam 関数は、AutoDial パラメーターの値を取得します。

構文

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

パラメーター

[in] unnamedParam1

取得する AutoDial パラメーターを指定します。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
RASADP_DisableConnectionQuery
 lpvValue パラメーターは、DWORD 値を返します。 この値が 0 (既定値) の場合、AutoDial は接続を作成する前にユーザーにクエリを実行するダイアログ ボックスを表示します。 この値が 1 で、AutoDial データベースにダイヤルする電話帳エントリがある場合、AutoDial はダイアログ ボックスを表示せずに接続を作成します。
RASADP_LoginSessionDisable
 lpvValue パラメーターは、DWORD 値を返します。 この値が 1 の場合、システムは現在のログオン セッションのすべての自動ダイヤル接続を無効にします。 この値が 0 (既定値) の場合、自動ダイヤル接続が有効になります。 AutoDial システム サービスは、新しいユーザーがワークステーションにログオンするときに、この値を 0 に変更します。
RASADP_SavedAddressesLimit
 lpvValue パラメーターは、レジストリに AutoDial が格納するアドレスの最大数を示す DWORD 値を返します。 AutoDial は、AutoDial 接続の作成に使用したアドレスを最初に格納します。次に、RAS 接続の作成後に学習したアドレスを格納します。 RasSetAutodialAddress 関数を使用して書き込まれたアドレスは常に保存され、制限の計算には含まれません。 既定値は 100 です。
RASADP_FailedConnectionTimeout
 lpvValue パラメーターは、タイムアウト値を示す DWORD 値を秒単位で返します。 自動ダイヤル接続の試行が失敗した場合、AutoDial システム サービスは、タイムアウト期間中に同じアドレスに到達する後続の試行を無効にします。 これにより、AutoDial では、アプリケーションによる同じ論理要求に対して複数の接続ダイアログ ボックスが表示されなくなります。 既定値は 5 です。
RASADP_ConnectionQueryTimeout
 lpvValue パラメーターは、タイムアウト値 (秒単位) を示す DWORD 値を指します。 自動ダイヤル接続を試みる前に、システムがダイヤルする必要があることをユーザーに確認するように求めるダイアログが表示されます。 ダイアログにはカウントダウン タイマーがあり、ユーザーが何もアクションを実行しない場合は、[ダイヤルしない] を選択してダイアログを終了します。 lpvValue が指す DWORD 値 、このカウントダウン タイマーの初期時間を指定します。

[out] unnamedParam2

指定したパラメーターの値を受け取るバッファーへのポインター。

[in, out] unnamedParam3

DWORD 値へのポインター。

入力時に、この値を設定して、lpvValue バッファーのサイズ (バイト単位) を示します。

出力時に、この値はバッファーに書き込まれた値の実際のサイズを示します。

戻り値

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

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

価値 意味
ERROR_INVALID_PARAMETER
 dwKey または lpvValue パラメーター が無効です。
ERROR_INVALID_SIZE
 lpdwcbValue で指定されたサイズが小さすぎます。

備考

手記

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

必要条件

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

関連項目

RasSetAutodialAddress

RasSetAutodialParam

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

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