WsCreateServiceProxyFromTemplate 函式 (webservices.h)
從原則範本建立 服務 Proxy 的協助程式常式。
語法
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列舉值，表示服務 Proxy 的通道類型。
properties
WS_PROXY_PROPERTY結構的陣列，其中包含服務 Proxy 的選擇性屬性。
此參數的值可以是 Null，在此情況下， propertyCount 參數必須是 0 (零) 。
[in] propertyCount
屬性陣列中的 屬性 數目。
[in] templateType
WS_BINDING_TEMPLATE_TYPE列舉值，表示用來建立服務 Proxy 的範本類型。
如需詳細資訊 ，請參閱 。
templateValue
要由應用程式建立和填入的選擇性範本結構。 此範本結構必須與 templateType) 中的輸入範本類型 (一致。 當 templateValue 參數為 Null時，它相當於初始化為零的對應範本結構。
如需詳細資訊 ，請參閱 。
[in] templateSize
templateValue參數) 中樣板結構的大小，以位元組為單位 (。
[in] templateDescription
templateValue的描述。 這必須符合 templateType。
如需詳細資訊 ，請參閱 。
[in] templateDescriptionSize
範本描述的大小。
serviceProxy
成功時，會接收代表新服務 Proxy 之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 |
| 程式庫 | WebServices.lib |
| Dll | WebServices.dll |