LCID (attribut)
L’attribut [ LCID ] spécifie un identificateur de paramètres régionaux et active la prise en charge du compilateur MIDL spécifique aux paramètres régionaux.
[
uuid(uuid-number),
lcid(localeID)
[, optional-attribute-list]
]
library library-name
{
library-definition-statements
}
function-name([parameter-attribute-list, lcid] long parameter-name,. . .);
Paramètres
-
UUID-Number
-
Spécifie un numéro d’identification unique universel pour la bibliothèque.
-
localeID
-
spécifie l’identificateur de paramètres régionaux 32 bits utilisé dans Windows prise en charge des langues nationales. En général, l’identificateur de paramètres régionaux est fourni au format hexadécimal.
-
Optional-attribute-List
-
Zéro, un ou plusieurs attributs à appliquer à la bibliothèque.
-
nom de la bibliothèque
-
Nom par lequel les composants logiciels font référence à la bibliothèque.
-
Bibliothèque-définition-instructions
-
Une ou plusieurs instructions MIDL qui définissent le contenu de la bibliothèque.
-
nom de fonction
-
Spécifie le nom de la fonction dans le fichier IDL.
-
Parameter-attribute-List
-
Zéro, un ou plusieurs attributs MIDL qui seront appliqués au paramètre de fonction.
-
nom du paramètre
-
Spécifie le nom du paramètre dans le fichier IDL.
Notes
La syntaxe [ ] LCID a deux formes différentes ; l’effet de l’attribut dépend de la syntaxe que vous utilisez, à savoir la syntaxe de l’instruction de la bibliothèque ou la syntaxe du paramètre.
En cas d’application à l’instruction Library , avec un argument LocaleID, comme indiqué dans le premier exemple, l’attribut [ LCID ] identifie les paramètres régionaux d’une bibliothèque de types ou d’un argument de fonction, et vous permet d’utiliser des caractères internationaux dans le bloc de bibliothèque.
Efficace avec la version 3.01.75 du compilateur MIDL, l’identificateur de paramètres régionaux fourni par cet attribut décore la bibliothèque de types résultante, mais modifie en fait le comportement du compilateur. Dans une instruction de bibliothèque , à partir du point où l’attribut [ LCID ] est utilisé, MIDL accepte les entrées localisées en fonction des paramètres régionaux spécifiés. En particulier, la prise en charge complète des langues asiatiques telles que le japonais, le chinois et le coréen (prise en charge complète des caractères DBCS) est disponible. Les fonctionnalités prises en charge par la localisation sont les suivantes : commentaires, chaînes, HelpStrings et identificateurs.
Utilisez le commutateur /LCID du compilateur pour que cette prise en charge de la localisation soit disponible pour l’ensemble du fichier d’entrée, y compris le nom de fichier et le chemin d’accès au répertoire, plutôt que simplement à l’intérieur du bloc de bibliothèque.
Lorsqu’il est appliqué à un paramètre, l’attribut [ LCID ] vous permet de passer un identificateur de paramètres régionaux à une fonction, comme indiqué dans le deuxième exemple. Les restrictions suivantes s’appliquent aux paramètres [ LCID ] :
- Une fonction ne peut avoir qu’un seul paramètre [ LCID ] .
- Le type de données du paramètre doit être long.
- La direction du paramètre doit être [ dans ] uniquement.
- Le paramètre [ LCID ] doit suivre tous les autres paramètres, à l’exception d’un [ paramètre retVal ] .
- Vous ne pouvez pas appliquer l’attribut [ LCID ] à un paramètre dispinterface ou coclass .
Exemples
[
uuid(12345678-1234-1234-1234-123456789ABC),
lcid(0x09),
version(1.0)
]
library MyLibrary
{
/* Library definition statements */
};
interface IMyFace : IDispatch
{
[propget] HRESULT MyFunc([in, lcid] long LocaleID,
[out, retval] BSTR * ReturnVal);
// Other interface definition statements
}