WsCreateServiceProxyFromTemplate-Funktion (webservices.h)

Hilfsroutine zum Erstellen eines Dienstproxys aus Richtlinienvorlagen.

Syntax

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
);

Parameter

[in] channelType

Ein WS_CHANNEL_TYPE Enumerationswert, der den Kanaltyp für den Dienstproxy darstellt.

properties

Ein Array von WS_PROXY_PROPERTY Strukturen, die optionale Eigenschaften für den Dienstproxy enthalten.

Der Wert dieses Parameters kann NULL sein. In diesem Fall muss der propertyCount-Parameter 0 (null) sein.

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

[in] templateType

Ein WS_BINDING_TEMPLATE_TYPE Enumerationswert, der den Typ der Vorlagen darstellt, die zum Erstellen des Dienstproxys verwendet werden.

Weitere Informationen finden Sie in den Anmerkungen .

templateValue

Die optionale Vorlagenstruktur, die von einer Anwendung erstellt und ausgefüllt werden soll. Diese Vorlagenstruktur muss mit dem Eingabevorlagentyp (in templateType) konsistent sein. Wenn der parameter templateValueNULL ist, entspricht er der entsprechenden Vorlagenstruktur, die mit null initialisiert wurde.

Weitere Informationen finden Sie in den Anmerkungen .

[in] templateSize

Die Größe der Vorlagenstruktur in Bytes (im templateValue-Parameter ).

[in] templateDescription

Die Beschreibung von templateValue. Dies muss mit templateType übereinstimmen.

Weitere Informationen finden Sie in den Anmerkungen .

[in] templateDescriptionSize

Die Größe der Vorlagenbeschreibung.

serviceProxy

Bei Erfolg ein Zeiger, der die Adresse der WS_SERVICE_PROXY-Struktur empfängt, die den neuen Dienstproxy darstellt.

Wenn Sie diese Struktur nicht mehr benötigen, müssen Sie sie freigeben, indem Sie WsFreeServiceProxy aufrufen.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

WsCreateServiceProxyFromTemplate erstellt die WS_SERVICE_PROXY-Struktur aus Eingaberichtlinienvorlagen und zusätzlichen Benutzereingaben.

Die folgende Tabelle zeigt die Zuordnung zwischen templateType-Werten und den entsprechenden Datentypen, die in templateValue und templateDescription verwendet werden sollen.

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll