attribut fault_status
L’attribut ACF [fault_status] spécifie qu’un code d’erreur de type error_status_t indique une défaillance de la procédure distante, plutôt que d’autres types de problèmes tels que des erreurs de communication.
[fault_status [ , ACF-function-attributes ] ] function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ... );
[ [ ACF-function-attributes ] ] function-name(
[fault_status [ , ACF-parameter-attributes ] ] parameter-name
, ... );
Paramètres
-
ACF-function-attributes
-
Spécifie zéro ou plusieurs attributs de fonction ACF, tels que [fault_status] et [nocode]. Les attributs de fonction sont placés entre crochets. Notez qu’un ou plusieurs attributs peuvent être appliqués à une fonction. Séparez plusieurs attributs de fonction par des virgules. Notez également que si [fault_status] apparaît en tant qu’attribut de fonction, il ne peut pas également apparaître en tant qu’attribut de paramètre.
-
nom de la fonction
-
Spécifie le nom de la fonction tel que défini dans le fichier IDL.
-
ACF-parameter-attributes
-
Spécifie les attributs qui s’appliquent à un paramètre. Notez que zéro ou plusieurs attributs peuvent être appliqués au paramètre. Les attributs de paramètre sont placés entre crochets. Séparez plusieurs attributs de paramètres par des virgules. Les attributs de paramètre IDL, tels que les attributs directionnels, ne sont pas autorisés dans l’ACF. Notez que si [fault_status] apparaît en tant qu’attribut de paramètre, il ne peut pas également apparaître en tant qu’attribut de fonction.
-
nom_paramètre
-
Spécifie le paramètre de la fonction tel que défini dans le fichier IDL. Chaque paramètre de la fonction doit être spécifié dans la même séquence, en utilisant le même nom que défini dans le fichier IDL.
Notes
L’attribut [fault_status] peut être utilisé en tant qu’attribut de fonction ou en tant qu’attribut de paramètre, mais il ne peut apparaître qu’une seule fois par fonction. Il peut être appliqué à la fonction elle-même ou à un paramètre dans chaque fonction.
L’attribut [fault_status] ne peut être appliqué qu’aux fonctions qui retournent le type error_status_t. Lorsque la procédure distante échoue d’une manière qui provoque le retour d’une erreur PDU, un code d’erreur est retourné.
Lorsque [fault_status] est utilisé comme attribut de paramètre, le paramètre doit être un paramètre [out] de type error_status_t. Si une erreur de serveur se produit, le paramètre est défini sur le code d’erreur. Une fois l’appel distant terminé, la procédure définit la valeur.
Le paramètre associé à l’attribut [fault_status] n’a pas besoin d’être spécifié dans le fichier IDL. Lorsque le paramètre n’est pas spécifié, un nouveau paramètre out de type error_status_t est généré après le dernier paramètre défini dans le fichier IDL DCE.
Il est possible que les attributs [fault_status] et [comm_status] apparaissent dans une seule fonction, sous forme d’attributs de fonction ou d’attributs de paramètre. Si les deux attributs sont des attributs de fonction, ou s’ils s’appliquent au même paramètre et qu’aucune erreur ne se produit, la fonction ou le paramètre a la valeur error_status_ok. Sinon, il contient la valeur de code status appropriée. Étant donné que les valeurs retournées pour [fault_status] sont différentes des valeurs retournées pour [comm_status], les valeurs retournées sont facilement interprétées.
Voir aussi