次の方法で共有

WSD_CONFIG_PARAM_TYPE列挙 (wsdbase.h)

  • [アーティクル]

WSD_CONFIG_PARAM構造体に格納されているデータの種類を指定します。

構文

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
これは、UDP メッセージの受信署名WS_Discovery確認するために使用されるパラメーターを指定するために使用されます。

pConfigData メンバーは、WSD_SECURITY_SIGNATURE_VALIDATION構造体へのポインターです。

dwConfigDataSize メンバーは、WSD_SECURITY_SIGNATURE_VALIDATION構造体のサイズです。
WSD_CONFIG_HOSTING_ADDRESSES
値: 9
これは 、WSDCreateDeviceHost2 関数にのみ適用されます。 デバイス ホストをホストするアドレスの配列を指定するために使用されます。 同等の機能は、WSDCreateDeviceHostAdvanced 関数の ppHostAddresses パラメーターと dwHostAddressCount パラメーターを使用して提供される機能です。

pConfigData メンバーは、WSD_CONFIG_ADDRESSES構造体へのポインターです。 この構造体の addresses メンバーは 、IWSDAddress オブジェクトの配列を指します。各オブジェクトは、デバイス ホストがリッスンするアドレスです。

dwConfigDataSize メンバーは、WSD_CONFIG_ADDRESSES構造体のサイズです。
WSD_CONFIG_DEVICE_ADDRESSES
値: 10
これは 、WSDCreateDeviceProxy2 関数にのみ適用されます。 プロキシを作成するデバイスのアドレスを指定するために使用されます。 同等の機能は、WSDCreateDeviceProxyAdvanced 関数の deviceConfig パラメーターを介して提供される機能です。

pConfigData メンバーは、WSD_CONFIG_ADDRESSES構造体へのポインターです。 この構造体の addresses メンバーは IWSDAddress オブジェクトの配列を指し、それぞれがプロキシが作成されるデバイスのアドレスです。 現在、許可されているアドレスは 1 つだけです。

dwConfigDataSize メンバーは、WSD_CONFIG_ADDRESSES構造体のサイズです。
WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH
値: 11
WSD_SECURITY_HTTP_AUTH_SCHEMESで指定された認証スキームのいずれかを使用した HTTP 認証の要件を示します。 具体的なシナリオは次のとおりです。



  • WSDCreateDeviceHost 操作中に指定した場合、HTTP 認証を使用して WSDAPI デバイス ホストの Hosted Services に送信されるメッセージを DPWS クライアントが認証する必要があります。



  • この値が 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 [デスクトップ アプリのみ]
Header wsdbase.h (Windows.h を含む)