attribut nocode
L’attribut [nocode] est utilisé dans les en-têtes ACF ou avec des fonctions individuelles pour empêcher la génération de code stub client.
[
nocode
[ , ACF-interface-attributes ]
]
interface interface-name
{
[ include filename-list ; ]
[ typedef [type-attribute-list] typename; ]
[ [ nocode [ , ACF-function-attributes ] ] function-name (
[ ACF-parameter-attributes ] parameter-name ;
...);
]
...
}
-
ACF-interface-attributes
-
Spécifie une liste d’un ou plusieurs attributs qui s’appliquent à l’interface dans son ensemble. Les attributs valides incluent [auto_handle] ou [implicit_handle] et [code] ou [nocode]. Lorsque plusieurs attributs d’interface sont présents, ils doivent être séparés par des virgules.
-
nom_interface
-
Spécifie le nom de l’interface. En mode de compatibilité DCE, le nom de l’interface doit correspondre au nom de l’interface spécifiée dans le fichier IDL. Lorsque vous utilisez le commutateur du compilateur MIDL /acf, le nom de l’interface dans ACF et le nom de l’interface dans le fichier IDL peuvent être différents.
-
filename-list
-
Spécifie une liste d’un ou plusieurs noms de fichiers d’en-tête en langage C, séparés par des virgules. Le nom de fichier complet, y compris l’extension, doit être fourni.
-
type-attribute-list
-
Spécifie une liste d’un ou plusieurs attributs, séparés par des virgules, qui s’appliquent au type spécifié. Les attributs de type valides incluent [allouer].
-
Typename
-
Spécifie un type défini dans le fichier IDL. Les attributs de type dans ACF ne peuvent être appliqués qu’aux types précédemment définis dans le fichier IDL.
-
ACF-function-attributes
-
Spécifie les attributs qui s’appliquent à la fonction dans son ensemble, tels que [comm_status]. Les attributs de fonction sont placés entre crochets. 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 ACF qui s’appliquent à un paramètre. Notez que zéro 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 ACF sont placés entre crochets.
-
nom_paramètre
-
Spécifie un 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 et en utilisant le même nom que défini dans le fichier IDL.
L’attribut [nocode] peut apparaître dans l’en-tête ACF, ou il peut être appliqué à une fonction individuelle.
Lorsque l’attribut [nocode] apparaît dans l’en-tête ACF, le code stub client n’est généré pour aucune fonction distante, sauf s’il a l’attribut de fonction [code]. Vous pouvez remplacer l’attribut [nocode] dans l’en-tête d’une fonction individuelle en spécifiant l’attribut [code] comme attribut de fonction.
Lorsque l’attribut [nocode] apparaît dans la liste d’attributs de la fonction, aucun code stub client n’est généré pour la fonction.
Le code stub client n’est pas généré lorsque :
- L’en-tête ACF inclut l’attribut [nocode].
- L’attribut [nocode] est appliqué à la fonction .
- L’attribut [local] s’applique à la fonction dans le fichier d’interface.
[code] ou [nocode] peut apparaître dans la liste d’attributs d’une fonction, et celui que vous choisissez peut apparaître exactement une fois.
L’attribut [nocode] est ignoré lorsque des stubs de serveur sont générés. Vous ne pouvez pas l’appliquer lors de la génération de stubs de serveur en mode de compatibilité DCE.