lcid 屬性

[ Lcid ] 屬性指定地區設定識別碼,並啟用地區設定特定的 MIDL 編譯器支援。

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

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

參數

uuid-數位

指定 媒體櫃的通用唯一識別碼。

localeID

指定用於 Windows 國語言支援的32位地區設定識別碼。 一般而言,地區設定識別碼會以十六進位提供。

選用-屬性-清單

要套用至連結 的零或多個屬性。

程式庫名稱

軟體元件參考連結 的名稱。

程式庫定義語句

定義連結 內容的一或多個 MIDL 語句。

函數名稱

在 IDL 檔案中指定函數的名稱。

參數屬性清單

將套用至函數參數的零或多個 MIDL 屬性。

參數-名稱

指定 IDL 檔案中的參數名稱。

備註

[ Lcid ] 語法有兩種不同的形式; 屬性的影響取決於您所使用的語法,例如連結 語句語法或參數語法。

當套用至連結 語句,以及 localeID 引數(如第一個範例所示)時, [ lcid ] 屬性會識別類型程式庫或函式引數的地區設定,並可讓您在程式庫區塊內使用國際字元。

自 MIDL 編譯器的版本3.01.75 起,此屬性所提供的地區設定識別碼不只會裝飾產生的類型程式庫,而是實際變更編譯器的行為。 在連結 語句中, [ ] MIDL 會根據所指定的地區設定,接受當地語系化的輸入。 特別是,日文、中文和韓文等亞洲語言的完整支援 (提供完整的 DBCS 支援) 。 當地語系化所支援的功能包括:批註、字串、helpstrings 和識別碼。

使用 /lcid 編譯器參數,讓整個輸入檔案都能使用此當地語系化支援,包括檔案名和目錄路徑,而不是只在程式庫區塊內。

當套用至參數時, [ lcid ] 屬性可讓您將地區設定識別碼傳遞至函式,如第二個範例所示。 下列限制適用于 [ lcid ] 參數:

  • 函數最多可以有一個 [ lcid ] 參數。
  • 參數的資料類型必須為 long
  • 參數的方向必須是 [ ]
  • [ Lcid ] 參數必須遵照任何其他參數,但 [ retval ] 參數除外。
  • 您無法將 [ lcid ] 屬性套用至 介面介面coclass參數。

範例

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

另請參閱

coclass

dispinterface

使用 MIDL 產生類型程式庫

/lcid

圖書館

ODL 檔語法

ODL 檔案範例

retval