Win32 API 日本語リファレンス
ホーム › Devices.WebServicesOnDevices › WSD_CONFIG_PARAM_TYPE

WSD_CONFIG_PARAM_TYPE

列挙型
📘 Microsoft Learn (日本語) · English
基底型i4

メンバー 13

名前10進16進説明
WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE10x1

pConfigData メンバーは、受信メッセージの最大サイズ (オクテット単位) を指定する DWORD へのポインターです。

dwConfigDataSize メンバーは 4 です。

WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE20x2

pConfigData メンバーは、送信メッセージの最大サイズ (オクテット単位) を指定する DWORD へのポインターです。

dwConfigDataSize メンバーは 4 です。

WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH30x3

SSL 接続におけるクライアント認証で WSDAPI が使用するクライアント証明書を渡すために使用します。

pConfigData メンバーは、クライアント証明書を表す CERT_CONTEXT 構造体へのポインターです。呼び出し元は、その証明書の秘密キーに対する読み取りアクセス権を持っている必要があります。

dwConfigDataSize メンバーは CERT_CONTEXT 構造体のサイズです。

WSD_SECURITY_SSL_SERVER_CERT_VALIDATION40x4

SSL サーバー証明書の検証情報を WSDAPI に渡すために使用します。SSL 接続を確立する際、WSDAPI は WSD_SECURITY_CERT_VALIDATION 構造体で指定された条件に一致するサーバー証明書のみを受け入れます。

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

dwConfigDataSize メンバーは WSD_SECURITY_CERT_VALIDATION 構造体のサイズです。

WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION50x5

SSL クライアント証明書の検証情報を WSDAPI に渡すために使用します。受信 SSL 接続でクライアント証明書が利用可能な場合、その証明書が WSD_SECURITY_CERT_VALIDATION 構造体で指定された検証条件に一致しなければ、WSDAPI は接続を拒否します。

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

dwConfigDataSize メンバーは WSD_SECURITY_CERT_VALIDATION 構造体のサイズです。

WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT60x6

受信 SSL 接続において、クライアントがまだクライアント証明書を提供していない場合に、WSDAPI が SSL クライアントに対してクライアント証明書を要求することを指定します。リモートエンティティがクライアント証明書を提供できない場合、接続は拒否されます。なお、そのポート用に作成される SSL レコードでは、クライアント証明書のネゴシエーションが明示的に許可されている必要があります。

pConfigData メンバーは NULL です。

dwConfigDataSize メンバーは 0 です。

WSD_SECURITY_COMPACTSIG_SIGNING_CERT70x7

送信する WS_Discovery UDP メッセージの署名に WSDAPI が使用する証明書を指定するために使用します。

pConfigData メンバーは、署名証明書を表す CERT_CONTEXT 構造体へのポインターです。呼び出し元は、その証明書の秘密キーに対する読み取りアクセス権を持っている必要があります。

dwConfigDataSize メンバーは CERT_CONTEXT 構造体のサイズです。

WSD_SECURITY_COMPACTSIG_VALIDATION80x8

受信した署名付き WS_Discovery UDP メッセージを検証するために使用するパラメーターを指定します。

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

dwConfigDataSize メンバーは WSD_SECURITY_SIGNATURE_VALIDATION 構造体のサイズです。

WSD_CONFIG_HOSTING_ADDRESSES90x9

これは WSDCreateDeviceHost2 関数にのみ適用されます。デバイスホストをホストするアドレスの配列を指定するために使用します。これは WSDCreateDeviceHostAdvanced 関数の ppHostAddresses および dwHostAddressCount パラメーターで提供される機能と同等です。

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

dwConfigDataSize メンバーは WSD_CONFIG_ADDRESSES 構造体のサイズです。

WSD_CONFIG_DEVICE_ADDRESSES100xA

これは WSDCreateDeviceProxy2 関数にのみ適用されます。プロキシの作成対象となるデバイスのアドレスを指定するために使用します。これは WSDCreateDeviceProxyAdvanced 関数の deviceConfig パラメーターで提供される機能と同等です。

pConfigData メンバーは WSD_CONFIG_ADDRESSES 構造体へのポインターです。この構造体の addresses メンバーは IWSDAddress オブジェクトの配列を指し、その各要素はプロキシの作成対象となるデバイスのアドレスです。現在のところ、指定できるアドレスは 1 つだけです。

dwConfigDataSize メンバーは WSD_CONFIG_ADDRESSES 構造体のサイズです。

WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH110xB

WSD_SECURITY_HTTP_AUTH_SCHEMES で指定された認証スキームのいずれかを使用した HTTP 認証が必要であることを示します。具体的なシナリオは次のとおりです。

  • WSDCreateDeviceHost 操作時に指定した場合、DPWS クライアントは WSDAPI デバイスホストのホステッドサービスに送信するメッセージを HTTP 認証で認証する必要があります。
  • この値を WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT と併せて指定した場合、WSDAPI は HTTP クライアントに対してクライアント証明書の送信と HTTP 認証の使用を要求します。
WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH120xC

この値を指定すると、WSDAPI は HTTP クライアントにクライアント証明書の送信を要求します。クライアントが証明書を提供できない場合、WSDAPI は HTTP 認証を要求します。クライアントがそのどちらも行えない場合、WSDAPI によって拒否されます。具体的なシナリオは次のとおりです。

  • WSDCreateDeviceHost 操作時に指定した場合、この動作は DPWS クライアントからの Web サービスメッセージに適用されます。
注 このパラメーターは WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT と併用できません。併用した場合、WSDAPI は E_INVALIDARG を返します。
WSD_SECURITY_USE_HTTP_CLIENT_AUTH130xD

サーバーが認証を要求する場合、WSDAPI は HTTP 認証を使用して認証を行います。具体的なシナリオは次のとおりです。

  • WSDCreateDeviceHost 操作時に指定した場合、この動作は DPWS クライアントからの Web サービスメッセージに適用されます。
  • この値を WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH と併せて指定した場合、サーバーがいずれかの操作を要求すると、WSDAPI はクライアント証明書を送信し、HTTP 認証を使用して認証を行います。

公式ドキュメント

<a href="/windows/desktop/api/wsdbase/ns-wsdbase-wsd_config_param">WSD_CONFIG_PARAM</a> 構造体に格納されるデータの種類を指定します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum WSD_CONFIG_PARAM_TYPE : int {
    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;
public enum WSD_CONFIG_PARAM_TYPE : int
{
    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,
}
Public Enum WSD_CONFIG_PARAM_TYPE As Integer
    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
End Enum
import enum

class WSD_CONFIG_PARAM_TYPE(enum.IntEnum):
    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
pub const WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE: i32 = 1;
pub const WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE: i32 = 2;
pub const WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH: i32 = 3;
pub const WSD_SECURITY_SSL_SERVER_CERT_VALIDATION: i32 = 4;
pub const WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION: i32 = 5;
pub const WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT: i32 = 6;
pub const WSD_SECURITY_COMPACTSIG_SIGNING_CERT: i32 = 7;
pub const WSD_SECURITY_COMPACTSIG_VALIDATION: i32 = 8;
pub const WSD_CONFIG_HOSTING_ADDRESSES: i32 = 9;
pub const WSD_CONFIG_DEVICE_ADDRESSES: i32 = 10;
pub const WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH: i32 = 11;
pub const WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH: i32 = 12;
pub const WSD_SECURITY_USE_HTTP_CLIENT_AUTH: i32 = 13;
// WSD_CONFIG_PARAM_TYPE
const (
	WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE int32 = 1
	WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE int32 = 2
	WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH int32 = 3
	WSD_SECURITY_SSL_SERVER_CERT_VALIDATION int32 = 4
	WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION int32 = 5
	WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT int32 = 6
	WSD_SECURITY_COMPACTSIG_SIGNING_CERT int32 = 7
	WSD_SECURITY_COMPACTSIG_VALIDATION int32 = 8
	WSD_CONFIG_HOSTING_ADDRESSES int32 = 9
	WSD_CONFIG_DEVICE_ADDRESSES int32 = 10
	WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH int32 = 11
	WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH int32 = 12
	WSD_SECURITY_USE_HTTP_CLIENT_AUTH int32 = 13
)
const
  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
pub const WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE: i32 = 1;
pub const WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE: i32 = 2;
pub const WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH: i32 = 3;
pub const WSD_SECURITY_SSL_SERVER_CERT_VALIDATION: i32 = 4;
pub const WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION: i32 = 5;
pub const WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT: i32 = 6;
pub const WSD_SECURITY_COMPACTSIG_SIGNING_CERT: i32 = 7;
pub const WSD_SECURITY_COMPACTSIG_VALIDATION: i32 = 8;
pub const WSD_CONFIG_HOSTING_ADDRESSES: i32 = 9;
pub const WSD_CONFIG_DEVICE_ADDRESSES: i32 = 10;
pub const WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH: i32 = 11;
pub const WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH: i32 = 12;
pub const WSD_SECURITY_USE_HTTP_CLIENT_AUTH: i32 = 13;
const
  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
enum WSD_CONFIG_PARAM_TYPE : int {
    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,
}
#define global WSD_CONFIG_MAX_INBOUND_MESSAGE_SIZE                  0x1
#define global WSD_CONFIG_MAX_OUTBOUND_MESSAGE_SIZE                 0x2
#define global WSD_SECURITY_SSL_CERT_FOR_CLIENT_AUTH                0x3
#define global WSD_SECURITY_SSL_SERVER_CERT_VALIDATION              0x4
#define global WSD_SECURITY_SSL_CLIENT_CERT_VALIDATION              0x5
#define global WSD_SECURITY_SSL_NEGOTIATE_CLIENT_CERT               0x6
#define global WSD_SECURITY_COMPACTSIG_SIGNING_CERT                 0x7
#define global WSD_SECURITY_COMPACTSIG_VALIDATION                   0x8
#define global WSD_CONFIG_HOSTING_ADDRESSES                         0x9
#define global WSD_CONFIG_DEVICE_ADDRESSES                          0xA
#define global WSD_SECURITY_REQUIRE_HTTP_CLIENT_AUTH                0xB
#define global WSD_SECURITY_REQUIRE_CLIENT_CERT_OR_HTTP_CLIENT_AUTH 0xC
#define global WSD_SECURITY_USE_HTTP_CLIENT_AUTH                    0xD