Condividi tramite


struttura SOCKET_PEER_TARGET_NAME (mstcpip.h)

La struttura SOCKET_PEER_TARGET_NAME contiene l'indirizzo IP e il nome per una destinazione peer e il tipo di protocollo di sicurezza da usare in un socket.

Sintassi

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

Members

SecurityProtocol

Valore SOCKET_SECURITY_PROTOCOL che identifica il tipo di protocollo usato per proteggere il traffico sul socket.

PeerAddress

Indirizzo IP del peer per il socket.

PeerTargetNameStringLen

Lunghezza, in byte, del nome della destinazione peer nel membro AllStrings .

AllStrings[0]

Nome della destinazione peer per il socket.

Commenti

La struttura SOCKET_PEER_TARGET_NAME è supportata in Windows Vista e versioni successive.

La struttura SOCKET_PEER_TARGET_NAME viene usata dalla funzione WSASetSocketPeerTargetName per specificare il nome della destinazione peer corrispondente a un indirizzo IP peer. Questo nome di destinazione deve essere specificato dalle applicazioni client per identificare in modo sicuro il peer che deve essere autenticato.

Attualmente, l'unico tipo di protocollo di sicurezza supportato è IPsec. La specifica di un valore di enumerazione di SOCKET_SECURITY_PROTOCOL_DEFAULT ha quindi lo stesso effetto di specificare SOCKET_SECURITY_PROTOCOL_IPSEC nel membro SecurityProtocol .

L'implementazione di IPsec in Windows Vista e Windows Server 2008 supporta solo l'autenticazione da computer a computer e da utente a computer. Di conseguenza, il nome di destinazione peer specificato nel membro AllStrings della struttura SOCKET_PEER_TARGET_NAME deve fare riferimento all'entità computer peer.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione mstcpip.h

Vedi anche

SOCKADDR_STORAGE

SOCKET_SECURITY_PROTOCOL

Uso delle estensioni Secure Socket

WSASetSocketPeerTargetName

Piattaforma filtro Windows

Funzioni API della piattaforma di filtro Di Windows

Estensioni del socket sicuro Winsock