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 |
| 頁首 |
|
| DLL |
|
另請參閱