Atribut lcid

Artikel
06/13/2023

Atribut [lcid] menentukan pengidentifikasi lokal dan memungkinkan dukungan kompilator MIDL khusus lokal.

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

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

Parameter

uuid-number: Menentukan nomor identifikasi unik universal untuk pustaka.
localeID: Menentukan pengidentifikasi lokal 32-bit yang digunakan dalam Dukungan Bahasa Nasional Windows. Biasanya pengidentifikasi lokal diberikan dalam heksadesimal.
optional-attribute-list: Nol atau beberapa atribut untuk diterapkan ke pustaka.
nama pustaka: Nama tempat komponen perangkat lunak merujuk ke pustaka.
pernyataan definisi pustaka: Satu atau beberapa pernyataan MIDL yang menentukan konten pustaka.
nama fungsi: Menentukan nama fungsi dalam file IDL.
parameter-attribute-list: Atribut MIDL nol atau lebih yang akan diterapkan ke parameter fungsi.
Nama parameter: Menentukan nama parameter dalam file IDL.

Keterangan

Sintaks [lcid] memiliki dua bentuk yang berbeda; efek atribut bergantung pada sintaks mana yang Anda gunakan — sintaks pernyataan pustaka atau sintaks parameter.

Saat diterapkan ke pernyataan pustaka , bersama dengan argumen localeID, seperti yang ditunjukkan dalam contoh pertama, atribut [lcid] mengidentifikasi lokal untuk pustaka jenis atau untuk argumen fungsi dan memungkinkan Anda menggunakan karakter internasional di dalam blok pustaka.

Efektif dengan versi 3.01.75 dari kompilator MIDL, pengidentifikasi lokal yang disediakan oleh atribut ini tidak hanya menghias pustaka jenis yang dihasilkan, tetapi benar-benar mengubah perilaku kompilator. Dalam pernyataan pustaka , dari titik di mana atribut [lcid] digunakan, MIDL akan menerima input yang dilokalkan sesuai dengan lokal yang ditentukan. Secara khusus, dukungan penuh untuk bahasa Asia seperti Jepang, Cina, dan Korea (dukungan DBCS penuh) tersedia. Fitur yang didukung oleh pelokalan adalah: komentar, string, helpstring, dan pengidentifikasi.

Gunakan sakelar pengkompilasi /lcid agar dukungan pelokalan ini tersedia untuk seluruh file input, termasuk nama file dan jalur direktori, bukan hanya di dalam blok pustaka.

Saat diterapkan ke parameter, atribut [lcid] memungkinkan Anda meneruskan pengidentifikasi lokal ke fungsi, seperti yang ditunjukkan pada contoh kedua. Pembatasan berikut berlaku untuk parameter [lcid] :

Fungsi dapat memiliki paling banyak satu parameter [lcid] .
Jenis data parameter harus panjang.
Arah parameter harus [in] saja.
Parameter [lcid] harus mengikuti parameter lain, kecuali parameter[retval].
Anda tidak dapat menerapkan atribut [lcid] ke parameter dispinterface atau coclass .

Contoh

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

Lihat juga

coclass
dispinterface
Membuat Pustaka Jenis Dengan MIDL
/lcid
pustaka
Sintaks File ODL
Contoh File ODL
retval

Bagikan melalui