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 |