次の方法で共有


PFN_WSK_GET_REMOTE_ADDRESS コールバック関数 (wsk.h)

WskGetRemoteAddress 関数は、接続指向またはストリーム ソケットのリモート トランスポート アドレスを取得します。

構文

PFN_WSK_GET_REMOTE_ADDRESS PfnWskGetRemoteAddress;

NTSTATUS PfnWskGetRemoteAddress(
  [in]      PWSK_SOCKET Socket,
  [out]     PSOCKADDR RemoteAddress,
  [in, out] PIRP Irp
)
{...}

パラメーター

[in] Socket

クエリ対象のソケットのソケット オブジェクトを指定する WSK_SOCKET 構造体へのポインター。

[out] RemoteAddress

ソケットのリモート トランスポート アドレスを受け取る呼び出し元によって割り当てられたバッファーへのポインター。 バッファーは、非ページ メモリに配置する必要があります。 また、バッファーは、WSK アプリケーションがソケットの作成時に指定したアドレス ファミリに対応する特定の SOCKADDR 構造体型を格納するのに十分な大きさにする必要があります。

WSK アプリケーションがリッスン ソケットで受け入れた接続指向ソケットの場合、アドレス ファミリは、WSK アプリケーションがリッスン ソケットを作成したときに指定したアドレス ファミリと同じです。

[in, out] Irp

WSK サブシステムが非同期的に取得操作を完了するために使用する呼び出し元によって割り当てられた IRP へのポインター。 WSK 関数での IRP の使用の詳細については、「 Winsock カーネル関数での IRP の使用」を参照してください。

戻り値

WskGetRemoteAddress は、次のいずれかの NTSTATUS コードを返します。

リターン コード 説明
STATUS_SUCCESS
ソケットのリモート トランスポート アドレスが正常に取得されました。 IRP は成功状態で完了します。
STATUS_PENDING
WSK サブシステムは、ソケットのリモート トランスポート アドレスをすぐに取得できませんでした。 WSK サブシステムは、ソケットのリモート トランスポート アドレスを取得した後、IRP を完了します。 取得操作の状態は、IRP の IoStatus.Status フィールドに返されます。
STATUS_INVALID_DEVICE_STATE
ソケットがリモート トランスポート アドレスに接続されていません。 IRP は失敗状態で完了します。
STATUS_FILE_FORCED_CLOSED
ソケットは機能しなくなりました。 IRP は失敗状態で完了します。 WSK アプリケーションは、できるだけ早くソケットを閉じる には、WskCloseSocket 関数を呼び出す必要があります。
その他の状態コード
エラーが発生しました。 IRP は失敗状態で完了します。

注釈

WSK アプリケーションは、リモート トランスポート アドレスに接続されている接続指向またはストリーム ソケットでのみ 、WskGetRemoteAddress 関数を呼び出すことができます。 ストリーム ソケットは、 WskConnect 関数を呼び出すことによってリモート トランスポート アドレスに接続されます。 接続指向ソケットは、次のいずれかの方法でリモート トランスポート アドレスに接続されます。

  • WSK アプリケーションは WskConnect 関数を呼び出します。
  • WSK アプリケーションは、 WskSocketConnect 関数を呼び出してソケットを作成、バインド、接続します。
  • WSK アプリケーションがリッスンしているソケットで受信接続要求を受け入れると、WSK サブシステムはソケットを接続します。
WskGetRemoteAddress 関数がSTATUS_PENDINGを返す場合は、IRP が完了するまで、RemoteAddress パラメーターが指すバッファーは有効なままである必要があります。 WSK アプリケーションが ExAllocateXxx 関数のいずれかを使用してバッファーを割り当てた場合、IRP が完了するまで、対応する ExFreeXxx 関数を使用してメモリを解放することはできません。 WSK アプリケーションがスタックにバッファーを割り当てた場合、IRP が完了するまで WskGetRemoteAddress 関数を呼び出す関数からを返すことはできません。

要件

要件
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header wsk.h (Wsk.h を含む)
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

Sockaddr

WSK_PROVIDER_CONNECTION_DISPATCH

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskAccept

WskAcceptEvent

WskBind

WskCloseSocket

WskConnect

WskGetLocalAddress

WskSocketConnect