WS_SET_CHANNEL_PROPERTY_CALLBACK fonction de rappel (webservices.h)

Article
08/27/2023

Gère l’appel WsSetChannelProperty pour un WS_CUSTOM_CHANNEL_BINDING.

Syntaxe

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
)
{...}

Paramètres

[in] channelInstance

Pointeur vers l’état spécifique à ce canal instance, tel que créé par le WS_CREATE_CHANNEL_CALLBACK.

[in] id

ID de la propriété à définir.

value

Pointeur vers la valeur de propriété à définir. Le pointeur doit avoir un alignement compatible avec le type de la propriété.

[in] valueSize

Taille de la valeur de la propriété.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Code de retour	Description
E_INVALIDARG	L’ID de propriété n’était pas pris en charge pour cet objet. La taille spécifiée n’était pas appropriée pour la propriété .
E_OUTOFMEMORY	Il n’y avait pas assez d’espace pour définir la valeur de la propriété.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Pour plus d’informations sur le contrat de cette API, consultez WsSetChannelProperty .

Il incombe à l’implémentation de canal personnalisé de déterminer l’ensemble de propriétés qu’elle souhaite prendre en charge.

Si une propriété n’est pas prise en charge, le E_INVALIDARG doit être retourné. (Voir Valeurs de retour des services web Windows.)

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	webservices.h

Partager via