NDK_FN_GET_LISTENER_LOCAL_ADDRESS コールバック関数 (ndkpi.h)

  • [アーティクル]

NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) 関数は、NDK リスナーのローカル アドレスを返します。

構文

NDK_FN_GET_LISTENER_LOCAL_ADDRESS NdkFnGetListenerLocalAddress;

NTSTATUS NdkFnGetListenerLocalAddress(
  [in] NDK_LISTENER *pNdkListener,
       PSOCKADDR pAddress,
       ULONG *pAddressLength
)
{...}

パラメーター

[in] pNdkListener

NDK リスナー オブジェクトへのポインター (NDK_LISTENER)。

pAddress

リスナーのローカル アドレスがこのバッファーで返されます。

pAddressLength

入力用のアドレス バッファーのサイズ (バイト単位)、および出力用にバッファーに書き込まれた実際のアドレスのサイズ (バイト単位)。

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 ローカル アドレスが pAddress パラメーターのバッファーに書き込まれた。
STATUS_BUFFER_TOO_SMALL
 *pAddressLength パラメーター入力で指定されたバッファー・サイズが小さすぎます。 *pAddressLength 出力値は、必要なバッファー サイズで更新されます。
その他の状態コード
 エラーが発生しました。

解説

NdkGetListenerLocalAddress は、リスナーのローカル アドレスを返します。 ローカル アドレスは、AF_INETまたはAF_INET6 リスナーのポート情報を取得する場合に便利です。 たとえば、NDK コンシューマーがリッスン要求の ND ポート番号として 0 を指定し、NDK プロバイダーがポートを指定した場合、NDK コンシューマーは NdkGetListenerLocalAddress を使用して、プロバイダーが指定したポートを決定できます。

要件

要件 値
サポートされている最小のクライアント サポートされていません。NDIS 6.30 以降でサポートされています。
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム Windows
ヘッダー ndkpi.h (Ndkpi.h を含む)
IRQL <=DISPATCH_LEVEL

こちらもご覧ください

NDK_FN_LISTEN

NDK_LISTENER