SOCKET_PEER_TARGET_NAME 構造体 (mstcpip.h)

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

こちらもご覧ください

SOCKADDR_STORAGE

SOCKET_SECURITY_PROTOCOL

Secure Socket Extensions の使用

WSASetSocketPeerTargetName

Windows フィルタリング プラットフォーム

Windows フィルタリング プラットフォーム API 関数

Winsock Secure Socket Extensions