次の方法で共有

RasGetAutodialAddressA 関数 (ras.h)

  • [アーティクル]

RasGetAutodialAddress 関数は、AutoDial マッピング データベースのネットワーク アドレスに関連付けられているすべての AutoDial エントリに関する情報を取得します。

構文

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

パラメーター

[in] unnamedParam1

情報が要求されるアドレスを指定する null-terminated 文字列へのポインター。 IP アドレス、インターネット ホスト名 ("www.microsoft.com")、または NetBIOS 名 ("products1") を指定できます。

このパラメーターが NULL場合、関数は既定のインターネット接続を取得します。 この関数は、構成されている場合、ユーザーごとの既定のインターネット接続を返します。 それ以外の場合、この関数はグローバルな既定のインターネット接続を返します。 既定のインターネット接続が構成されていない場合、この関数は lpdwcbAutoDialEntries に対して 0 を返し、lpdwcAutoDialEntries パラメーターを します。

[in] unnamedParam2

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

[in, out] unnamedParam3

出力時に、lpszAddress パラメーターで指定されたアドレスに関連付けられた AutoDial エントリごとに 1 つずつ、RASAUTODIALENTRY 構造体の配列を受け取るバッファーへのポインター。

入力時に、バッファー内の最初の RASAUTODIALENTRY 構造体の dwSize メンバーを sizeof(RASAUTODIALENTRY) に設定して、構造体のバージョンを識別します。

lpAutoDialEntries NULL場合、RasGetAutodialAddress は、必要なバッファー サイズ (バイト単位)、および AutoDial エントリの数を示す lpdwcAutoDialEntries パラメーターと lpdwcAutoDialEntries パラメーターを設定します。

[in, out] unnamedParam4

入力時に、lpAutoDialEntries バッファーのサイズをバイト単位で指定する変数へのポインター。

出力時に、この変数は返されたバイト数、またはバッファーが小さすぎる場合に必要なバイト数を受け取ります。

[out] unnamedParam5

lpAutoDialEntries バッファーで返される構造体要素の数を受け取る変数へのポインター。

戻り値

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

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

価値 意味
ERROR_INVALID_SIZE
 RASAUTODIALENTRY 構造体の dwSize メンバーが無効な値です。
ERROR_INVALID_PARAMETER
 lpszAddress、lpdwcbAutoDialEntries、または lpdwcAutoDialEntries パラメーター が NULLされました。

備考

リモート アクセス サービス (RAS) では、既定のインターネット接続がサポートされています。 RAS は、ローカル コンピューターへのグローバルな既定のインターネット接続をサポートし、さらに、各ユーザーの既定のインターネット接続をサポートします。

グローバルな既定のインターネット接続の名前は、次のレジストリ キーの下のレジストリに格納されます。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

接続の名前を格納する値は次のとおりです。

DefaultInternet の

この値は REG_SZ型です。

グローバルな既定のインターネット接続は、として構成する必要があります。すべてのユーザー、接続フォルダー ユーザー インターフェイスに接続します。

ユーザーごとの既定のインターネット接続の名前は、次のレジストリ キーの下のレジストリに格納されます。

HKEY_CURRENT_USER\ソフトウェア\Microsoft\Ras Autodial\既定の

接続の名前を格納する値は次のとおりです。

DefaultInternet の

この値は REG_SZ型です。

手記

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

必要条件

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

関連項目

RASAUTODIALENTRY の

RasEnumAutodialAddresses

RasSetAutodialAddress

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

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