attributo lcid

Articolo
06/13/2023

L'attributo [lcid] specifica un identificatore delle impostazioni locali e abilita il supporto del compilatore MIDL specifico delle impostazioni locali.

[
    uuid(uuid-number), 
    lcid(localeID)
    [, optional-attribute-list]
] 
library library-name
{ 
    library-definition-statements
}

function-name([parameter-attribute-list, lcid] long  parameter-name,. . .);

Parametri

uuid-number: Specifica un numero di identificazione univoco universale per la libreria.
Localeid: Specifica l'identificatore delle impostazioni locali a 32 bit usato nel supporto per la lingua nazionale di Windows. In genere l'identificatore delle impostazioni locali viene specificato in esadecimale.
facoltativo-attributo-list: Zero o più attributi da applicare alla libreria.
nome della libreria: Nome in base al quale i componenti software fanno riferimento alla libreria.
istruzioni library-definition-statements: Una o più istruzioni MIDL che definiscono il contenuto della libreria.
nome funzione: Specifica il nome della funzione nel file IDL.
parameter-attribute-list: Zero o più attributi MIDL che verranno applicati al parametro della funzione.
nome parametro: Specifica il nome del parametro nel file IDL.

Commenti

La sintassi [lcid] ha due forme diverse; l'effetto dell'attributo dipende dalla sintassi usata, ovvero la sintassi dell'istruzione della libreria o la sintassi dei parametri.

Quando applicato all'istruzione libreria, insieme a un argomento localeID, come illustrato nel primo esempio, l'attributo [lcid] identifica le impostazioni locali per una libreria di tipi o per un argomento di funzione e consente di usare caratteri internazionali all'interno del blocco di libreria.

Efficace con la versione 3.01.75 del compilatore MIDL, l'identificatore delle impostazioni locali fornito da questo attributo non solo decora la libreria dei tipi risultante, ma modifica effettivamente il comportamento del compilatore. All'interno di un'istruzione della libreria , dal punto in cui viene usato l'attributo [lcid] , MIDL accetterà l'input localizzato in base alle impostazioni locali specificate. In particolare, è disponibile il supporto completo per le lingue asiatiche, ad esempio giapponese, cinese e coreano (supporto DBCS completo). Le funzionalità supportate dalla localizzazione sono: commenti, stringhe, helpstrings e identificatori.

Usare l'opzione del compilatore /lcid per avere questo supporto di localizzazione disponibile per l'intero file di input, incluso il nome del file e il percorso della directory, anziché solo all'interno del blocco di libreria.

Se applicato a un parametro, l'attributo [lcid] consente di passare un identificatore delle impostazioni locali a una funzione, come illustrato nel secondo esempio. Le restrizioni seguenti si applicano ai parametri [lcid] :

Una funzione può avere al massimo un parametro [lcid].
Il tipo di dati del parametro deve essere lungo.
La direzione del parametro deve essere [in] solo.
Il parametro [lcid] deve seguire qualsiasi altro parametro, ad eccezione di un parametro [retval].
Non è possibile applicare l'attributo [lcid] a un parametro dispinterface o coclasse .

Esempi

[  
    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
}

Vedere anche

coclass
dispinterface
Generazione di una libreria di tipi con MIDL
/Lcid
library
Sintassi del file ODL
Esempio di file ODL
retval

Condividi tramite