指定した DNS ホスト名についての IPHostEntry 情報の非同期要求を開始します。
Public Shared Function BeginGetHostByName( _
ByVal hostName As String, _ ByVal requestCallback As AsyncCallback, _ ByVal stateObject As Object _) As IAsyncResult
[C#]
public static IAsyncResult BeginGetHostByName(stringhostName,AsyncCallbackrequestCallback,objectstateObject);
[C++]
public: static IAsyncResult* BeginGetHostByName(String* hostName,AsyncCallback* requestCallback,Object* stateObject);
[JScript]
public static function BeginGetHostByName(
hostName : String,requestCallback : AsyncCallback,stateObject : Object) : IAsyncResult;
パラメータ
- hostName
ホストの DNS 名を格納する文字列。 - requestCallback
AsyncCallback 。 - stateObject
状態オブジェクト。
戻り値
非同期要求を参照する IAsyncResult インスタンス。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentNullException | hostName が null 参照 (Visual Basic では Nothing) です。 |
| SecurityException | 呼び出し元に、DNS 情報にアクセスするためのアクセス許可がありません。 |
| SocketException | DNS クエリの実行中にエラーが発生しました。 |
解説
BeginGetHostByName メソッドは、DNS ホスト情報の非同期要求を開始します。非同期コールバック メソッドは、 EndGetHostByName メソッドを使用して実際のホスト情報を返します。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
.NET Framework セキュリティ:
- DnsPermission (DNS にアクセスするために必要なアクセス許可) PermissionState.Unrestricted (関連する列挙体)