WS_SET_CHANNEL_PROPERTY_CALLBACK Rückruffunktion (webservices.h)

Artikel
08/27/2023

Verarbeitet den WsSetChannelProperty-Aufruf für eine WS_CUSTOM_CHANNEL_BINDING.

Syntax

WS_SET_CHANNEL_PROPERTY_CALLBACK WsSetChannelPropertyCallback;

HRESULT WsSetChannelPropertyCallback(
  [in]           void *channelInstance,
  [in]           WS_CHANNEL_PROPERTY_ID id,
                 const void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] channelInstance

Der Zeiger auf den für diesen Kanal spezifischen Zustand instance, wie er vom WS_CREATE_CHANNEL_CALLBACK erstellt wurde.

[in] id

Die ID der festzulegenden Eigenschaft.

value

Der Zeiger auf den festzulegenden Eigenschaftswert. Der Zeiger muss über eine Ausrichtung verfügen, die mit dem Typ der Eigenschaft kompatibel ist.

[in] valueSize

Die Größe des Eigenschaftswerts.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Rückgabecode	Beschreibung
E_INVALIDARG	Die Eigenschafts-ID wurde für dieses Objekt nicht unterstützt. Die angegebene Größe war für die -Eigenschaft nicht geeignet.
E_OUTOFMEMORY	Es war nicht genügend Speicherplatz vorhanden, um den Eigenschaftswert festzulegen.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Informationen zum Vertrag dieser API finden Sie unter WsSetChannelProperty .

Die Implementierung des benutzerdefinierten Kanals muss den Satz von Eigenschaften bestimmen, die unterstützt werden sollen.

Wenn eine Eigenschaft nicht unterstützt wird, sollte die E_INVALIDARG zurückgegeben werden. (Siehe Rückgabewerte für Windows-Webdienste.)

Anforderungen


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

Freigeben über