WsCreateServiceProxyFromTemplate 関数 (webservices.h)

ポリシー テンプレートから サービス プロキシ を作成するためのヘルパー ルーチン。

構文

HRESULT WsCreateServiceProxyFromTemplate(
  [in]           WS_CHANNEL_TYPE          channelType,
                 const WS_PROXY_PROPERTY  *properties,
  [in]           const ULONG              propertyCount,
  [in]           WS_BINDING_TEMPLATE_TYPE templateType,
                 void                     *templateValue,
  [in]           ULONG                    templateSize,
  [in]           const void               *templateDescription,
  [in]           ULONG                    templateDescriptionSize,
                 WS_SERVICE_PROXY         **serviceProxy,
  [in, optional] WS_ERROR                 *error
);

パラメーター

[in] channelType

サービス プロキシのチャネルの種類を表す WS_CHANNEL_TYPE 列挙値。

properties

サービス プロキシの省略可能なプロパティを含む WS_PROXY_PROPERTY 構造体の配列。

このパラメーターの値は NULL にすることができます。この場合、 propertyCount パラメーターは 0 (ゼロ) である必要があります。

[in] propertyCount

プロパティ配列内の プロパティ の数。

[in] templateType

サービス プロキシの作成に使用されるテンプレートの種類を表す WS_BINDING_TEMPLATE_TYPE 列挙値。

詳細については、「 備考 」を参照してください。

templateValue

アプリケーションによって作成および入力される省略可能なテンプレート構造。 このテンプレート構造は、入力テンプレートの種類 ( templateType 内) と一致している必要があります。 templateValue パラメーターが NULL の場合、対応するテンプレート構造が 0 に初期化されているのと同じです。

詳細については、「 備考 」を参照してください。

[in] templateSize

( templateValue パラメーター内の) テンプレート構造のサイズ (バイト単位)。

[in] templateDescription

templateValue の説明。 これは templateType と一致する必要があります。

詳細については、「 備考 」を参照してください。

[in] templateDescriptionSize

テンプレートの説明のサイズ。

serviceProxy

成功した場合、新しいサービス プロキシを表す WS_SERVICE_PROXY 構造体のアドレスを受け取るポインター。

この構造体が不要になった場合は、 WsFreeServiceProxy を呼び出して解放する必要があります。

[in, optional] error

関数が失敗した場合に追加のエラー情報を受け取る WS_ERROR 構造体へのポインター。

戻り値

関数が成功すると、NO_ERRORが返されます。それ以外の場合は、HRESULT エラー コードが返されます。

解説

WsCreateServiceProxyFromTemplate は、入力ポリシー テンプレートと追加のユーザー入力から WS_SERVICE_PROXY 構造を作成します。

次の表は、 templateType 値と templateValue と templateDescription で使用される対応するデータ型のマッピングを示しています。

templateType	templateValue	templateDescription
WS_HTTP_BINDING_TEMPLATE_TYPE	WS_HTTP_BINDING_TEMPLATE	WS_HTTP_POLICY_DESCRIPTION
WS_HTTP_SSL_BINDING_TEMPLATE_TYPE	WS_HTTP_SSL_BINDING_TEMPLATE	WS_HTTP_SSL_POLICY_DESCRIPTION
WS_HTTP_HEADER_AUTH_BINDING_TEMPLATE_TYPE	WS_HTTP_HEADER_AUTH_BINDING_TEMPLATE	WS_HTTP_HEADER_AUTH_POLICY_DESCRIPTION
WS_HTTP_SSL_HEADER_AUTH_BINDING_TEMPLATE_TYPE	WS_HTTP_SSL_HEADER_AUTH_BINDING_TEMPLATE	WS_HTTP_SSL_HEADER_AUTH_POLICY_DESCRIPTION
WS_HTTP_SSL_USERNAME_BINDING_TEMPLATE_TYPE	WS_HTTP_SSL_USERNAME_BINDING_TEMPLATE	WS_HTTP_SSL_USERNAME_POLICY_DESCRIPTION
WS_HTTP_SSL_KERBEROS_APREQ_BINDING_TEMPLATE_TYPE	WS_HTTP_SSL_KERBEROS_APREQ_BINDING_TEMPLATE	WS_HTTP_SSL_KERBEROS_APREQ_POLICY_DESCRIPTION
WS_TCP_BINDING_TEMPLATE_TYPE	WS_TCP_BINDING_TEMPLATE	WS_TCP_POLICY_DESCRIPTION
WS_TCP_SSPI_BINDING_TEMPLATE_TYPE	WS_TCP_SSPI_BINDING_TEMPLATE	WS_TCP_SSPI_POLICY_DESCRIPTION
WS_TCP_SSPI_USERNAME_BINDING_TEMPLATE_TYPE	WS_TCP_SSPI_USERNAME_BINDING_TEMPLATE	WS_TCP_SSPI_USERNAME_POLICY_DESCRIPTION
WS_TCP_SSPI_KERBEROS_APREQ_BINDING_TEMPLATE_TYPE	WS_TCP_SSPI_KERBEROS_APREQ_BINDING_TEMPLATE	WS_TCP_SSPI_KERBEROS_APREQ_POLICY_DESCRIPTION
WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE	WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE	WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_POLICY_DESCRIPTION
WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE	WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE	WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_POLICY_DESCRIPTION
WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE	WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE	WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_POLICY_DESCRIPTION
WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE	WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE	WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_POLICY_DESCRIPTION

要件

サポートされている最小のクライアント	Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	webservices.h
Library	WebServices.lib
[DLL]	WebServices.dll