WsCreateServiceProxy-Funktion (webservices.h)

Artikel
08/27/2023

Erstellt einen Dienstproxy mit den angegebenen Eigenschaften.

Syntax

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 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.

[in] channelBinding

Ein WS_CHANNEL_BINDING Enumerationswert, der die Kanalbindung darstellt.

[in, optional] securityDescription

Eine WS_SECURITY_DESCRIPTION-Struktur , die die Sicherheitsbeschreibung 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 .

channelProperties

Ein Array von WS_CHANNEL_PROPERTY Strukturen, die optionale Kanaleigenschaften enthalten. Der Wert dieses Parameters kann NULL sein. In diesem Fall muss der channelPropertyCount-Parameter 0 (Null) sein.

Hinweis Seien Sie sehr vorsichtig, wenn Sie die Standardwerte für diese Eigenschaften ändern.

[in] channelPropertyCount

Die Anzahl der Eigenschaften im ChannelProperties-Array .

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.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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