SOCKET_SECURITY_QUERY_TEMPLATE 구조체(mstcpip.h)

아티클
08/25/2023

SOCKET_SECURITY_QUERY_TEMPLATE 구조에는 WSAQuerySocketSecurity 함수에서 사용하는 보안 템플릿이 포함되어 있습니다.

구문

typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTokenAccessMask;
} SOCKET_SECURITY_QUERY_TEMPLATE;

멤버

SecurityProtocol

트래픽을 보호하는 데 사용되는 프로토콜을 식별하는 SOCKET_SECURITY_PROTOCOL 값입니다.

PeerAddress

보안 정보를 쿼리할 피어의 IP 주소입니다. 연결 지향 소켓( IPPROTO_TCP 프로토콜)의 경우 연결된 소켓은 피어를 고유하게 식별합니다. 이 경우 이 매개 변수는 무시됩니다.

PeerTokenAccessMask

쿼리 정보의 일부로 반환되는 피어 사용자 애플리케이션 및 컴퓨터 토큰 핸들을 여는 데 사용되는 액세스 마스크입니다.

설명

SOCKET_SECURITY_QUERY_TEMPLATE 구조는 Windows Vista 이상에서 지원됩니다.

SOCKET_SECURITY_QUERY_TEMPLATE 구조는 WSAQuerySocketSecurity 함수에서 소켓에 대해 반환할 쿼리 정보의 유형을 지정하는 데 사용됩니다. WSAQuerySocketSecurity 함수에 전달된 SOCKET_SECURITY_QUERY_TEMPLATE 구조체에는 모든 멤버가 기본 보안 정보를 요청하는 0이 포함될 수 있습니다.

SOCKET_SECURITY_QUERY_TEMPLATE 구조체가 지정되지 않은 PeerTokenAccessMask 멤버로 지정된 경우(0으로 설정) WSAQuerySocketSecurity 함수는 SOCKET_SECURITY_QUERY_INFO 구조체에서 PeerApplicationAccessTokenHandle 및 PeerMachineAccessTokenHandle 멤버를 반환하지 않습니다.

현재 지원되는 유일한 보안 프로토콜 유형은 IPsec입니다. 따라서 SecurityProtocol 멤버에 대해 SOCKET_SECURITY_PROTOCOL_DEFAULT 열거형 값을 지정하면 SOCKET_SECURITY_PROTOCOL_IPSEC 지정하는 것과 같은 효과가 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	mstcpip.h