attribut error_status_t

Le mot clé error_status_t désigne un type pour un objet qui contient des informations de status de communication ou de status d’erreur.

[ [ , ACF-function-attributes ] ] error_status_t function-name(
        [ [ ACF-parameter-attributes ] ] parameter-name
        , ...);

[ [ ACF-function-attributes ] ] function-name(
    [ [ ACF-parameter-attributes ] ] error_status_t parameter-name
    , ...);

Paramètres

ACF-function-attributes

Spécifie zéro ou plusieurs attributs de fonction ACF, tels que [comm_status],[fault_status] ou [nocode]. Les attributs de fonction sont placés entre crochets. Zéro ou plusieurs attributs peuvent être appliqués à une fonction. Séparez plusieurs attributs de fonction par des virgules.

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, un ou plusieurs attributs peuvent être appliqués au paramètre. Séparez plusieurs attributs de paramètres par des virgules. Les attributs de paramètre sont placés entre crochets. Les attributs de paramètre IDL, tels que les attributs directionnels, ne sont pas autorisés dans l’ACF.

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

Le type error_status_t est utilisé dans le cadre de l’architecture de gestion des exceptions dans IDL. Ce type correspond à un longnon signé. Les applications qui interceptent les situations d’erreur ont un paramètre [out] ou un type de retour d’une procédure spécifiée comme error_status_t, et qualifient les error_status_t avec les attributs [comm_status] ou [fault_status] dans l’ACF. Si le paramètre ou le type de retour n’était pas qualifié avec les attributs [comm_status] ou [fault_status], le paramètre fonctionne comme s’il s’agissait d’un long non signé.

À compter de la version 2.0, le compilateur MIDL génère des stubs qui contiennent l’architecture de gestion des erreurs appropriée. Toutefois, les versions antérieures du compilateur MIDL géraient un paramètre ou un type de retour de error_status_t comme si les attributs [comm_status] et [fault_status] avaient été appliqués, même s’ils ne l’étaient pas. Avec MIDL 2.0 ou version ultérieure, vous devez appliquer explicitement les attributs [comm_status] et [fault_status] au paramètre ou à la procédure dans l’ACF.

Le type error_status_t est l’un des types prédéfinis du langage de définition d’interface. Les types prédéfinis peuvent apparaître en tant que spécificateurs de type dans les déclarations typedef , dans les déclarations générales et dans les déclarateurs de fonction (soit en tant que type de fonction-retour, soit en tant que spécificateurs de type de paramètre).

Voir aussi

comm_status

fault_status

Fichier de définition d’interface (IDL)

Long

out

Typedef

Unsigned