WsCreateServiceEndpointFromTemplate-Funktion (webservices.h)

Artikel
08/27/2023

Hilfsroutine zum Erstellen eines Dienstendpunkts (WS_SERVICE_ENDPOINT) aus Richtlinienvorlagen.

Syntax

HRESULT WsCreateServiceEndpointFromTemplate(
  [in]           WS_CHANNEL_TYPE                    channelType,
  [in]           const WS_SERVICE_ENDPOINT_PROPERTY *properties,
  [in]           ULONG                              propertyCount,
  [in, optional] const WS_STRING                    *addressUrl,
  [in]           const WS_SERVICE_CONTRACT          *contract,
  [in]           WS_SERVICE_SECURITY_CALLBACK       authorizationCallback,
  [in]           WS_HEAP                            *heap,
  [in]           WS_BINDING_TEMPLATE_TYPE           templateType,
  [in]           void                               *templateValue,
  [in]           ULONG                              templateSize,
  [in]           const void                         *templateDescription,
  [in]           ULONG                              templateDescriptionSize,
  [out]          WS_SERVICE_ENDPOINT                **serviceEndpoint,
  [in, optional] WS_ERROR                           *error
);

Parameter

[in] channelType

Ein WS_CHANNEL_TYPE Enumerationswert, der den Typ des vom Endpunkt gehosteten Kanals darstellt.

[in] properties

Ein Array von WS_SERVICE_ENDPOINT_PROPERTY Strukturen, die Eigenschaften für den Dienstendpunkt enthalten. (Die Anwendung sollte Kanaleigenschaften in der Vorlagenstruktur ausfüllen.)

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

[in, optional] addressUrl

Die URL-Adresse, an der der Endpunkt lauschen soll.

[in] contract

Eine WS_SERVICE_CONTRACT-Struktur , die den Vertrag des Endpunkts darstellt.

[in] authorizationCallback

Ein WS_SERVICE_SECURITY_CALLBACK Autorisierungsrückruf für den Dienstendpunkt.

[in] heap

Der Heap , aus dem arbeitsspeicher für den Dienstendpunkt bei erfolgreicher Rückgabe zugeordnet wird.

[in] templateType

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

[in] templateValue

Optionale Vorlagenstruktur, die nach Anwendung erstellt und ausgefüllt werden soll. Die Vorlage muss mit dem Eingabevorlagentyp (übergeben im templateType-Parameter ) konsistent sein. Wenn der parameter templateValueNULL ist, entspricht er der entsprechenden Vorlagenstruktur, die mit null initialisiert wurde.

[in] templateSize

Die Größe der TemplateValue-Struktur der Eingabe in Byte.

[in] templateDescription

Die Beschreibung der Vorlagenstruktur (übergeben im templateValue-Parameter ). Muss mit templateType übereinstimmen.

[in] templateDescriptionSize

Die Größe der Vorlagenbeschreibung.

[out] serviceEndpoint

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

[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

WsCreateServiceEndpointFromTemplate erstellt die WS_SERVICE_ENDPOINT-Struktur aus den angegebenen Eingaberichtlinienvorlagen und zusätzlichen Benutzereingaben.

Anforderungen

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

Freigeben über