Partager via

énumération WS_FAULT_ERROR_PROPERTY_ID (webservices.h)

  • Article

Informations sur une erreur.

Syntax

typedef enum {
  WS_FAULT_ERROR_PROPERTY_FAULT = 0,
  WS_FAULT_ERROR_PROPERTY_ACTION = 1,
  WS_FAULT_ERROR_PROPERTY_HEADER = 2
} WS_FAULT_ERROR_PROPERTY_ID;

Constantes

 
WS_FAULT_ERROR_PROPERTY_FAULT
Valeur : 0
Valeur WS_FAULT facultative qui est la représentation d’erreur de l’erreur. Si Non
la représentation d’erreur est présente, puis la valeur est NULL.


Pour définir la valeur WS_FAULT, transmettez une WS_FAULT* à WsSetFaultErrorProperty.
L’objet d’erreur effectue une copie du WS_FAULT. L’objet error sera également
ajouter la chaîne d’erreur de l’erreur à l’ensemble de chaînes d’erreur dans l’objet d’erreur
si la langue de la chaîne d’erreur correspond à celle de l’objet d’erreur.


Pour obtenir la valeur WS_FAULT, passez une WS_FAULT** à WsGetFaultErrorProperty,
qui retourne la valeur NULL (indiquant qu’aucune erreur n’a été définie) ou
retourne un pointeur non NULL vers le WS_FAULT. Le pointeur non NULL est valide jusqu’à ce que
WsResetError ou WsFreeError sont appelés pour l’objet d’erreur.


La valeur par défaut est NULL.
WS_FAULT_ERROR_PROPERTY_ACTION
Valeur : 1
Valeur WS_XML_STRING facultative représentant l’action à utiliser pour l’erreur.
Si la longueur de la chaîne est égale à zéro, aucune action n’est présente.


Pour obtenir la valeur de chaîne, passez un WS_XML_STRING* à WsGetFaultErrorProperty.
La chaîne retournée est valide jusqu’à WsResetError ou WsFreeError
sont appelés pour l’objet d’erreur.


Pour définir la valeur de chaîne, passez une WS_XML_STRING* à WsSetFaultErrorProperty.
L’objet d’erreur effectue une copie de la chaîne.


La valeur par défaut est une chaîne de longueur nulle.
WS_FAULT_ERROR_PROPERTY_HEADER
Valeur : 2
Valeur WS_XML_BUFFER facultative représentant un en-tête à
ajouter au message d’erreur relatif à l’erreur.
Si le pointeur vers le XML_BUFFER a la valeur NULL, aucun en-tête n’est présent.


Pour obtenir la valeur d’en-tête, passez une WS_XML_BUFFER** à WsGetFaultErrorProperty.
Le WS_XML_BUFFER retourné est valide jusqu’à WsResetError ou WsFreeError
sont appelés pour l’objet d’erreur.


Pour définir la valeur d’en-tête, transmettez un WS_XML_BUFFER** à WsSetFaultErrorProperty.
L’objet d’erreur effectue une copie de la mémoire tampon.


La valeur par défaut est NULL.

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]
En-tête webservices.h