SOCKET_SECURITY_SETTINGS結構 (mstcpip.h)

  • 發行項

SOCKET_SECURITY_SETTINGS結構會指定通訊端的一般安全性需求。

語法

typedef struct _SOCKET_SECURITY_SETTINGS {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG                    SecurityFlags;
} SOCKET_SECURITY_SETTINGS;

成員

SecurityProtocol

SOCKET_SECURITY_PROTOCOL值，識別要用於通訊端的安全性通訊協定類型。

SecurityFlags

一組旗標，可讓應用程式在通訊端上設定特定安全性需求。 可能的值定義在 Mstcpip.h 標頭檔中。

值 意義
SOCKET_SETTINGS_GUARANTEE_ENCRYPTION
0x00000001
 表示需要保證流量加密。 如果預設原則偏好使用不使用加密的保護方法，則應該設定此旗標。 如果已設定此旗標且基於任何原因而無法加密，則不會傳送封包，且不會建立連線。
SOCKET_SETTINGS_ALLOW_INSECURE
0x00000002
 表示允許純文字連線。 如果設定此旗標，部分或所有傳送的封包將會以純文字傳送，特別是無法交涉對等安全性時。
注意 如果未設定此旗標，保證封包永遠不會以純文字傳送，即使安全性交涉失敗也一樣。
 

備註

Windows Vista 和更新版本支援 SOCKET_SECURITY_SETTINGS 結構。

WSASetSocketSecurity函式會使用SOCKET_SECURITY_SETTINGS結構，在通訊端上啟用和套用安全性。

此結構中未定址的安全性設定衍生自系統預設原則或系統管理設定的原則。 建議大部分的應用程式在SecurityProtocol成員中指定SOCKET_SECURITY_PROTOCOL列舉的 SOCKET_SECURITY_PROTOCOL_DEFAULT值。 這可讓應用程式與安全性通訊協定保持中性，並允許在不同系統之間進行更輕鬆的部署。

進階應用程式可以將安全性通訊協定和相關聯的設定轉換成 SOCKET_SECURITY_SETTINGS類型來 指定它們。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 mstcpip.h

另請參閱

SOCKET_SECURITY_PROTOCOL

使用安全通訊端延伸模組

WSASetSocketSecurity

Windows 篩選平台

Windows 篩選平台 API 函式

Winsock 安全通訊端延伸模組