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