共用方式為

wsdbase.h) WSD_CONFIG_PARAM_TYPE (列舉

  • 發行項

指定儲存在 WSD_CONFIG_PARAM 結構中的資料種類。

Syntax

typedef enum __MIDL___MIDL_itf_wsdbase_0000_0000_0001 {
  WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE = 1,
  WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE = 2,
  WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH = 3,
  WSD_SECURITY_SSL_SERVER_CERT_VALIDATION = 4,
  WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION = 5,
  WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT = 6,
  WSD_SECURITY_COMPACTSIG_SIGNING_CERT = 7,
  WSD_SECURITY_COMPACTSIG_VALIDATION = 8,
  WSD_CONFIG_HOSTING_ADDRESSES = 9,
  WSD_CONFIG_DEVICE_ADDRESSES = 10,
  WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH = 11,
  WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH = 12,
  WSD_SECURITY_USE_HTTP_CLIENT_AUTH = 13
} WSD_CONFIG_PARAM_TYPE;

常數

 
WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE
值： 1
pConfigData成員是DWORD的指標，指定輸入訊息的大小上限，以八位為單位。

dwConfigDataSize成員為 4。
WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE
值： 2
pConfigData成員是DWORD的指標，指定輸出訊息的大小上限，以八位為單位。

dwConfigDataSize成員為 4。
WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH
值： 3
用來傳入 WSDAPI 將用於 SSL 連線中用戶端驗證的用戶端憑證。

pConfigData成員是代表用戶端憑證之CERT_CONTEXT結構的指標。 呼叫端必須具有憑證私密金鑰的讀取權限。

dwConfigDataSize成員是CERT_CONTEXT結構的大小。
WSD_SECURITY_SSL_SERVER_CERT_VALIDATION
值： 4
用來將 SSL 伺服器憑證驗證資訊傳入 WSDAPI。 建立 SSL 連線時，WSDAPI 只會接受符合 WSD_SECURITY_CERT_VALIDATION 結構所指定準則的伺服器憑證。

pConfigData成員是WSD_SECURITY_CERT_VALIDATION結構的指標。

dwConfigDataSize成員是WSD_SECURITY_CERT_VALIDATION結構的大小。
WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION
值： 5
用來將 SSL 用戶端憑證驗證資訊傳入 WSDAPI。 在傳入 SSL 連線上，如果用戶端憑證可用，如果用戶端憑證不符合 WSD_SECURITY_CERT_VALIDATION 結構所指定的驗證準則，WSDAPI 將會拒絕連線。

pConfigData成員是WSD_SECURITY_CERT_VALIDATION結構的指標。

dwConfigDataSize成員是WSD_SECURITY_CERT_VALIDATION結構的大小。
WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT
值： 6
指定在傳入 SSL 連線上，如果用戶端尚未提供用戶端憑證，WSDAPI 會向 SSL 用戶端要求用戶端憑證。 如果遠端實體無法提供用戶端憑證，將會拒絕連線。 請注意，為該埠建立的 SSL 記錄必須明確允許用戶端憑證交涉。

pConfigData成員為Null。

dwConfigDataSize成員為 0。
WSD_SECURITY_COMPACTSIG_SIGNING_CERT
值： 7
用來指定 WSDAPI 要使用的憑證，以簽署輸出WS_Discovery UDP 訊息。

pConfigData成員是代表簽署憑證之CERT_CONTEXT結構的指標。 呼叫端必須具有憑證私密金鑰的讀取權限。

dwConfigDataSize成員是CERT_CONTEXT結構的大小。
WSD_SECURITY_COMPACTSIG_VALIDATION
值： 8
這是用來指定用來驗證輸入簽署WS_Discovery UDP 訊息的參數。

pConfigData成員是WSD_SECURITY_SIGNATURE_VALIDATION結構的指標。

dwConfigDataSize成員是WSD_SECURITY_SIGNATURE_VALIDATION結構的大小。
WSD_CONFIG_HOSTING_ADDRESSES
值： 9
這只適用于 WSDCreateDeviceHost2 函式。 它用來指定裝置主機應該裝載的位址陣列。 對等功能是透過WSDCreateDeviceHostAdvanced函式的ppHostAddresses和dwHostAddressCount參數所提供的功能。

pConfigData成員是WSD_CONFIG_ADDRESSES結構的指標。 這個結構的 address 成員會指向 IWSDAddress 物件的陣列，每個物件都是裝置主機將接聽的位址。

dwConfigDataSize成員是WSD_CONFIG_ADDRESSES結構的大小。
WSD_CONFIG_DEVICE_ADDRESSES
值： 10
這只適用于 WSDCreateDeviceProxy2 函式。 它用來指定建立 Proxy 之裝置的位址。 對等功能是透過WSDCreateDeviceProxyAdvanced函式的deviceConfig參數提供的功能。

pConfigData成員是WSD_CONFIG_ADDRESSES結構的指標。 這個結構的 address 成員指向 IWSDAddress 物件的陣列，每個物件都是建立 Proxy 之裝置的位址。 目前只允許一個這類位址。

dwConfigDataSize成員是WSD_CONFIG_ADDRESSES結構的大小。
WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH
值： 11
表示使用透過 WSD_SECURITY_HTTP_AUTH_SCHEMES 指定的其中一個驗證配置來要求 HTTP 驗證。 具體案例包括：



  • 在 WSDCreateDeviceHost 作業期間指定時，DPWS 用戶端必須使用 HTTP 驗證來驗證傳送至 WSDAPI 裝置主機託管服務的訊息。



  • 如果此值與WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT一起表示，則 WSDAPI 會要求 HTTP 用戶端傳送用戶端憑證，並使用 HTTP 驗證。


WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH
值： 12
指定此值時，WSDAPI 會要求 HTTP 用戶端傳送用戶端憑證。 如果用戶端無法提供，WSDAPI 將需要 HTTP 驗證。 如果用戶端無法這麼做，WSDAPI 將會拒絕它。 具體案例包括：



  • 在 WSDCreateDeviceHost 作業期間指定時，此行為會套用至 DPWS 用戶端的 Web 服務訊息。



注意 這個參數不能與WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT搭配使用。 如果是，WSDAPI 會傳回E_INVALIDARG。

 
WSD_SECURITY_USE_HTTP_CLIENT_AUTH
值： 13
如果伺服器需要驗證，WSDAPI 會使用 HTTP 驗證進行驗證。 具體案例包括：



  • 在 WSDCreateDeviceHost 作業期間指定時，此行為會套用至 DPWS 用戶端的 Web 服務訊息。



  • 如果此值與 WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH 一起表示，WSDAPI 會傳送用戶端憑證，並在伺服器需要任一作業時使用 HTTP 驗證進行驗證。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 wsdbase.h (包含 Windows.h)