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 で終わる文字列へのポインター。 IP アドレス、インターネット ホスト名 ("www.microsoft.com")、または NetBIOS 名 ("products1") を指定できます。
このパラメーターが NULL の場合、関数は既定のインターネット接続を取得します。 この関数は、構成されている場合は、ユーザーごとの既定のインターネット接続を返します。 それ以外の場合、関数はグローバルな既定のインターネット接続を返します。 既定のインターネット接続が構成されていない場合、この関数は lpdwcbAutoDialEntries パラメーターと lpdwcAutoDialEntries パラメーターに対して 0 を返します。
[in] unnamedParam2
予約; は NULL である必要があります。
[in, out] unnamedParam3
出力時に、lpszAddress パラメーターで指定されたアドレスに関連付けられた AutoDial エントリごとに 1 つずつ、RASAUTODIALENTRY 構造体の配列を受け取るバッファーへのポインター。
入力時に、バッファー内の最初の RASAUTODIALENTRY 構造体の dwSize メンバーを sizeof(RASAUTODIALENTRY) に設定して、構造体のバージョンを識別します。
lpAutoDialEntries が NULL の場合、RasGetAutodialAddress は lpdwcbAutoDialEntries パラメーターと lpdwcAutoDialEntries パラメーターを設定して、必要なバッファー サイズ (バイト単位)、および AutoDial エントリの数を示します。
[in, out] unnamedParam4
入力時に lpAutoDialEntries バッファーのサイズをバイト単位で指定する変数へのポインター。
出力時に、この変数は返されたバイト数、またはバッファーが小さすぎる場合に必要なバイト数を受け取ります。
[out] unnamedParam5
lpAutoDialEntries バッファーで返される構造体要素の数を受け取る変数へのポインター。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
関数が失敗した場合、戻り値は次のいずれかのエラー コードか、 ルーティングとリモート アクセスのエラー コード または Winerror.h からの値です。
値 | 意味 |
---|---|
|
RASAUTODIALENTRY 構造体の dwSize メンバーが無効な値です。 |
|
lpszAddress、lpdwcbAutoDialEntries、または lpdwcAutoDialEntries パラメーターが NULL でした。 |
注釈
リモート アクセス サービス (RAS) では、既定のインターネット接続がサポートされています。 RAS は、ローカル コンピューターにグローバルな既定のインターネット接続をサポートし、さらに、各ユーザーの既定のインターネット接続をサポートします。
グローバルな既定のインターネット接続の名前は、次のレジストリ キーの下のレジストリに格納されます。
HKEY_LOCAL_MACHINE Software Microsoft Ras Autodial Default
接続の名前を格納する値は次のとおりです。
DefaultInternet
この値は REG_SZ 型です。
グローバルな既定のインターネット接続は、Connections フォルダーユーザー インターフェイスのすべてのユーザー接続として構成する必要があります。
ユーザーごとの既定のインターネット接続の名前は、次のレジストリ キーの下のレジストリに格納されます。
Hkey_current_user\ソフトウェア\マイクロソフト\Ras Autodial\既定
接続の名前を格納する値は次のとおりです。
DefaultInternet
この値は REG_SZ 型です。
注意
ras.h ヘッダーは RasGetAutodialAddress をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ras.h |
Library | Rasapi32.lib |
[DLL] | Rasapi32.dll |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示