WsWriteMessageStart, fonction (webservices.h)
Écrivez tous les en-têtes du message dans le canal et préparez-vous à écrire les éléments de corps.
Syntaxe
HRESULT WsWriteMessageStart(
[in] WS_CHANNEL *channel,
[in] WS_MESSAGE *message,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Paramètres
[in] channel
Canal à utiliser pour écrire le message.
[in] message
Message à écrire.
[in, optional] asyncContext
Informations sur l’appel de la fonction de manière asynchrone ou NULL si l’appel est synchrone.
[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
Cette fonction peut retourner l’une de ces valeurs.
Code de retour | Description |
---|---|
|
L’opération asynchrone est toujours en attente. |
|
L'opération a été abandonnée. |
|
L’opération n’est pas autorisée en raison de l’état actuel de l’objet. |
|
Le point de terminaison distant n’existe pas ou est introuvable. |
|
L’accès a été refusé par le point de terminaison distant. |
|
La connexion avec le point de terminaison distant a été interrompue. |
|
Le point de terminaison distant n’a pas pu traiter la demande. |
|
Le point de terminaison distant n’est actuellement pas en service à cet emplacement. |
|
Le point de terminaison distant ne peut pas traiter la demande en raison d’une surcharge. |
|
Le point de terminaison distant n’était pas accessible. |
|
L’URL de l’adresse du point de terminaison n’est pas valide. |
|
Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue. |
|
L’opération ne s’est pas terminée dans le délai imparti. |
|
L’accès a été refusé par le serveur proxy HTTP. |
|
Le serveur proxy HTTP n’a pas pu traiter la demande. |
|
Un quota a été dépassé. |
|
La vérification de sécurité n’a pas réussi pour les données reçues. |
|
Une opération de sécurité a échoué dans l’infrastructure des services web Windows. |
|
Un jeton de sécurité a été rejeté par le serveur, car il a expiré. |
|
Le serveur proxy HTTP nécessite un schéma d’authentification HTTP « de base ». |
|
Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « digest ». |
|
Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « negotiate ». |
|
Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « NTLM ». |
|
Le point de terminaison distant nécessite le schéma d’authentification HTTP « de base ». |
|
Le point de terminaison distant nécessite le schéma d’authentification HTTP « digest ». |
|
Le point de terminaison distant nécessite le schéma d’authentification HTTP « negotiate ». |
|
Le point de terminaison distant nécessite le schéma d’authentification HTTP « NTLM ». |
|
Un certificat requis n’est pas dans sa période de validité lors de la vérification par rapport à l’horloge système actuelle ou à l’horodatage dans le fichier signé. |
|
Le nom CN des certificats ne correspond pas à la valeur passée. |
|
Chaîne de certificats traitée, mais terminée dans un certificat racine qui n’est pas approuvé par le fournisseur d’approbation. |
|
Le certificat n'est pas valide pour l'utilisation demandée. |
|
La fonction de révocation n’a pas pu vérifier la révocation car le serveur de révocation était déconnecté. |
|
Nous avons manqué de mémoire. |
|
Un ou plusieurs arguments ne sont pas valides. |
|
Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus. |
Remarques
Le début du message, y compris l’ensemble actuel d’en-têtes qui existe dans le message, est écrit dans le canal.
Cette fonction est semblable à WsWriteEnvelopeStart , mais elle est utilisée avec les canaux.
Le message doit être à l’état WS_MESSAGE_STATE_INITIALIZED . Une fois le message réussi, le message est passé à WS_MESSAGE_STATE_WRITING’état .
Pour sérialiser un élément du corps du message, utilisez WsWriteBody. Pour écrire directement dans l’enregistreur XML du message, commencez par obtenir le lecteur à l’aide de la propriété WS_MESSAGE_PROPERTY_BODY_WRITER .
Si la sortie du canal est diffusée en continu (WS_STREAMED_OUTPUT_TRANSFER_MODE), WsFlushBody doit être appelé pour transmettre réellement chaque partie du corps.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | webservices.h |
Bibliothèque | WebServices.lib |
DLL | WebServices.dll |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour