SOCKET_PEER_TARGET_NAME 構造体 (mstcpip.h)

[アーティクル]
02/29/2024

SOCKET_PEER_TARGET_NAME構造体には、ピアターゲットの IP アドレスと名前、およびソケットで使用されるセキュリティプロトコルの種類が含まれます。

構文

typedef struct _SOCKET_PEER_TARGET_NAME {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTargetNameStringLen;
  wchar_t                  AllStrings[0];
} SOCKET_PEER_TARGET_NAME;

メンバー

SecurityProtocol

ソケット上のトラフィックをセキュリティで保護するために使用されるプロトコルの種類を識別する SOCKET_SECURITY_PROTOCOL 値。

PeerAddress

ソケットのピアの IP アドレス。

PeerTargetNameStringLen

AllStrings メンバーのピアターゲット名の長さ (バイト単位)。

AllStrings[0]

ソケットのピアターゲット名。

注釈

SOCKET_PEER_TARGET_NAME構造は、Windows Vista 以降でサポートされています。

SOCKET_PEER_TARGET_NAME構造体は、WSASetSocketPeerTargetName 関数によって使用され、ピア IP アドレスに対応するピアターゲット名を指定します。このターゲット名は、認証する必要があるピアを安全に識別するために、クライアントアプリケーションによって指定されることを意図しています。

現在、サポートされているセキュリティプロトコルの種類は IPsec のみです。そのため、SOCKET_SECURITY_PROTOCOL_DEFAULT の列挙値を指定すると、SecurityProtocol メンバーでSOCKET_SECURITY_PROTOCOL_IPSECを指定する場合と同じ効果があります。

Windows Vista および Windows Server 2008 での IPsec の実装では、コンピューター間認証とユーザー間認証のみがサポートされます。その結果、SOCKET_PEER_TARGET_NAME構造体の AllStrings メンバーで指定されたピアターゲット名は、ピアコンピュータープリンシパルを参照する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	mstcpip.h