SOCKET_SECURITY_SETTINGS_IPSEC 구조체(mstcpip.h)
SOCKET_SECURITY_SETTINGS_IPSEC 구조는 IPsec과 관련된 다양한 보안 요구 사항 및 설정을 지정합니다.
구문
typedef struct _SOCKET_SECURITY_SETTINGS_IPSEC {
SOCKET_SECURITY_PROTOCOL SecurityProtocol;
ULONG SecurityFlags;
ULONG IpsecFlags;
GUID AuthipMMPolicyKey;
GUID AuthipQMPolicyKey;
GUID Reserved;
UINT64 Reserved2;
ULONG UserNameStringLen;
ULONG DomainNameStringLen;
ULONG PasswordStringLen;
wchar_t AllStrings[0];
} SOCKET_SECURITY_SETTINGS_IPSEC;
멤버
SecurityProtocol
형식: SOCKET_SECURITY_PROTOCOL
소켓에서 사용할 보안 프로토콜 유형을 식별하는 SOCKET_SECURITY_PROTOCOL 값입니다. 이 멤버는 SOCKET_SECURITY_PROTOCOL_IPSEC 설정해야 합니다.
SecurityFlags
형식: ULONG
애플리케이션이 소켓에서 특정 보안 요구 사항을 설정할 수 있도록 하는 플래그 집합입니다. 가능한 값은 Mstcpip.h 헤더 파일에 정의됩니다.
IpsecFlags
형식: ULONG
IPsec 보안 설정에 대한 플래그입니다. 가능한 값은 Mstcpip.h 헤더 파일에 정의됩니다.
AuthipMMPolicyKey
형식: GUID
AuthIP 기본 모드 공급자 컨텍스트의 Windows 필터링 플랫폼 키에 대한 GUID입니다. 애플리케이션이 사용자 지정 기본 모드 정책을 사용하려는 경우 먼저 FwpmProviderContextAdd0 함수를 사용하여 해당 공급자 컨텍스트를 추가하고 이 멤버에서 반환된 키를 지정해야 합니다. GUID가 0인 경우 이 필드는 무시됩니다.
AuthipQMPolicyKey
형식: GUID
AuthIp 빠른 모드 공급자 컨텍스트의 Windows 필터링 플랫폼 키입니다. 애플리케이션에서 사용자 지정 빠른 모드 정책을 사용하려는 경우 먼저 FwpmProviderContextAdd0 함수를 사용하여 해당 공급자 컨텍스트를 추가하고 이 필드에 반환된 키를 지정해야 합니다. GUID가 0인 경우 이 필드는 무시됩니다.
Reserved
형식: GUID
다음에 사용하도록 예약됩니다.
Reserved2
형식: UINT64
다음에 사용하도록 예약됩니다.
UserNameStringLen
형식: ULONG
AllStrings 멤버의 사용자 이름 길이(바이트)입니다.
DomainNameStringLen
형식: ULONG
AllStrings 멤버의 도메인 이름 길이(바이트)입니다.
PasswordStringLen
형식: ULONG
AllStrings 멤버의 암호 길이(바이트)입니다.
AllStrings[0]
형식: wchar_t[]
이 순서로 연결된 사용자 이름, 도메인 이름 및 암호를 포함하는 문자열입니다.
설명
SOCKET_SECURITY_SETTINGS_IPSEC 구조는 Windows Vista 이상에서 지원됩니다.
SOCKET_SECURITY_SETTINGS_IPSEC 구조는 더 많은 유연성이 필요하고 트래픽에 대한 IPSec 정책을 사용자 지정하려는 고급 애플리케이션에서 사용됩니다. SOCKET_SECURITY_SETTINGS_IPSEC 구조체에 대한 포인터는 WSASetSocketSecurity 함수를 호출하여 소켓에서 보안을 사용하도록 설정하고 적용할 때 SOCKET_SECURITY_SETTINGS 구조체 형식으로 캐스팅해야 합니다.
SOCKET_SECURITY_SETTINGS_IPSEC 구조체의 SecurityProtocol 멤버는 SOCKET_SECURITY_PROTOCOL_DEFAULT 아니라SOCKET_SECURITY_PROTOCOL_IPSEC 설정해야 합니다.
IPsec(인터넷 프로토콜 보안) 배포를 간소화하기 위해 Windows Vista 이상에서는 인증된 인터넷 프로토콜(AuthIP)이라는 향상된 버전의 IKE(인터넷 키 교환) 프로토콜을 지원합니다. AuthIP는 여러 구성에서 간소화된 IPsec 정책 구성 및 유지 관리를 제공하고 IPsec 피어 인증을 위한 추가 유연성을 제공합니다.
SOCKET_SECURITY_SETTINGS_IPSEC 구조에 지정된 일부 IPsec 설정이 소켓의 네트워크 트래픽에 적용되는 실제 설정과 다를 수 있습니다. 예를 들어 애플리케이션이 사용자 지정 기본 모드 또는 빠른 모드 정책을 지정하지만 우선 순위가 높은 다른 정책(예: 도메인 정책)이 동일한 트래픽에 대해 충돌하는 설정을 지정하는 경우에 발생할 수 있습니다. 이러한 충돌을 인식하기 위해 애플리케이션은 Windows 필터링 플랫폼 API를 사용하여 적용되는 정책을 쿼리하고 알림을 구독할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | mstcpip.h |