共用方式為


DownlevelGetLocaleScripts 函式

提供指定地區設定的文稿清單。

注意

此函式僅供在 Windows Vista 前作業系統上執行的應用程式使用。 其使用需要下載套件。 只在 Windows Vista 和更新版本上執行的應用程式應該呼叫 GetLocaleInfo ,並將 LCType 設定為 LOCALE_SSCRIPTS

 

語法

int DownlevelGetLocaleScripts(
  _In_  LPCWSTR lpLocaleName,
  _Out_ LPWSTR  lpScripts,
  _In_  int     cchScripts
);

參數

lpLocaleName [in]

以 Null 結尾 的地區設定名稱指標。

lpScripts [out]

緩衝區的指標,此函式會使用 ISO 15924 中使用的 4 個字元表示法,擷取代表腳本清單的 Null 終止字串。 每個腳本名稱都包含四個拉丁字元,並以字母順序擷取名稱。 每一個,包括最後一個,後面接著分號。

或者,如果 cchScripts 設定為 0,此參數可以包含 NULL。 在此情況下,函式會傳回腳本緩衝區所需的大小。

cchScripts [in]

大小,以字元為單位,表示 lpScripts 所 指示的腳本緩衝區。

或者,應用程式可以將此參數設定為 0。 在此情況下,函式會在 lpScripts擷取 NULL,並傳回腳本緩衝區所需的大小。

傳回值

傳回腳本緩衝區中擷取的字元數,包括終止的 Null 字元。 如果函式成功且 cchScripts 的值為 0,則傳回值是腳本緩衝區所需的大小,包括終止 Null 字元的字元。

如果函式未成功,則此函式會傳回 0。 若要取得擴充的錯誤資訊,應用程式可以呼叫 GetLastError,以傳回下列其中一個錯誤碼:

  • ERROR_BADDB。 函式無法存取數據。 這種情況通常不應該發生,而且通常表示安裝不正確、磁碟問題或類似。
  • ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大,或設定為 NULL 不正確
  • ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

此函式在策略中很有用,可降低與國際化功能變數名稱 (IDN) 相關的安全性問題。

以下是此函式的一些輸入和輸出範例,假設有足夠的緩衝區大小:

地區設定 lpLocaleName lpScripts
英文 (美國) zh-TW Latn;
印度文 (印度) hi-IN Deva;
日文 (日本) ja-JP 哈尼族;Hira;假名;

 

除非它是用於地區設定之寫入系統的基本部分,否則清單不包含拉丁文腳本。 不過,拉丁字元通常用於地區設定的內容中,而不是原生的地區設定,例如外國商業名稱。 在上述印度印度文範例中,擷取的唯一腳本是 “Deva” (適用於 Devanagari),不過拉丁字元也可以出現在印度文文字中。 DownlevelVerifyScripts 函式具有特殊旗標來處理該案例。

必要的頭檔與 DLL 是可從 archive.org 取得的「Microsoft 國際化功能變數名稱 (IDN) 風險降低 API」 下載的一部分。

需求

需求
最低支援的用戶端
Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
可轉散發套件
Windows XP 上的 Microsoft 國際化功能變數名稱 (IDN) 風險降低 API (SP2 或更新版本)、Windows Server 2003 (SP1 或更新版本),或 Windows Vista
頁首
Idndl.h
DLL
Idndl.dll

另請參閱

國家語言支援

國家語言支援函式

處理國際化網域名稱 (IDN)

DownlevelGetStringScripts

DownlevelVerifyScripts

GetLocaleInfo