共用方式為


DownlevelGetStringScripts 函式

提供指定 Unicode 字串中使用的文稿清單。

注意

此函式僅供在 Windows Vista 前作業系統上執行的應用程式使用。 其使用需要下載套件。 只在 Windows Vista 和更新版本上執行的應用程式應該呼叫 GetStringScripts

 

語法

int DownlevelGetStringScripts(
  _In_  DWORD   dwFlags,
  _In_  LPCWSTR lpString,
  _In_  int     cchString,
  _Out_ LPWSTR  lpScripts,
  _In_  int     cchScripts
);

參數

dwFlags [in]

指定文稿擷取選項的旗標。

意義
GSS_ALLOW_INHERITED_COMMON
擷取 “Qaii” (INHERITED) 和 “Zyyy” (COMMON) 腳本資訊。 這個值不會影響未指派字元的處理。 輸入字串中的這些字元一律會導致腳本字串中出現 「Zzzz」 (UNASSIGNED 腳本)。

 

注意

根據預設,此函式會忽略輸入 Unicode 字串中的任何繼承或通用字元。 如果未設定GSS_ALLOW_INHERITED_COMMON,即使輸入字串包含這類字元,“Qaii” 還是 “Zyyy” 都不會出現在腳本字串中。 如果已設定GSS_ALLOW_INHERITED_COMMON,而且輸入字串包含繼承和/或通用字元,則腳本字串中會出現 “Qaii” 和/或 “Zyyy”。 請參閱<備註>一節。

 

lpString [in]

要分析的 Unicode 字串指標。

cchString [in]

大小,以字元為單位,為 lpString指示的 Unicode 字串。 如果字串以 Null 終止,應用程式會將此參數設定為 -1。 如果應用程式將此參數設定為 0,函式會在 lpScripts擷取 Null Unicode 字串串 (L“\0”),並傳回 1。

lpScripts [out]

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

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

cchScripts [in]

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

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

傳回值

如果成功 且 cchScripts 設定為非零值,則傳回輸出緩衝區中擷取的字元數,包括終止 Null 字元。 函式會傳回 1,指出找不到任何腳本,例如,當輸入字串只包含 COMMON 或 INHERITED 字元且未設定GSS_ALLOW_INHERITED_COMMON時。 假設每個找到的腳本都會新增五個字元(四個字元 + 分隔符),簡單的數學運算會提供腳本計數為 (return_code - 1) / 5。

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

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

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

備註

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

腳本判斷是以 中 https://www.unicode.org/Public/4.1.0/ucd/Scripts.txtUnicode 聯盟所發佈的腳本值為基礎,不同之處在於未指派的字元具有值 “Zzzz” (UNASSIGNED),而不是 “Zyyy” (COMMON)。

以下是此函式行為的一些範例:

輸入字串

dwFlags

lpScripts

指令碼

Microsoft.com

0

Latn;

拉丁文

Microsoft.com

GSS_ALLOW_INHERITED_COMMON

Latn;齊伊;

拉丁文 + 通用

${ROWSPAN2}$Ni ño${REMOVE}$

004E 0069 0241 006F

${ROWSPAN2}$GSS_ALLOW_INHERITED_COMMON${REMOVE}$

${ROWSPAN2}$Latn;${REMOVE}$

${ROWSPAN2}$Latin${REMOVE}$

使用 LATIN SMALL LETTER N WITH TILDE

${ROWSPAN2}$Ni ño${REMOVE}$

004E 0069 006E 0303 006F

${ROWSPAN2}$GSS_ALLOW_INHERITED_COMMON${REMOVE}$

${ROWSPAN2}$Latn;Qaii;${REMOVE}$

${ROWSPAN2}$Latin + 繼承${REMOVE}$

使用 COMBINING TILDE

${ROWSPAN2}$Sp оf${REMOVE}$

0053 0070 043e 043e 0066

${ROWSPAN2}$0${REMOVE}$

${ROWSPAN2}$Latn;Cyrl;${REMOVE}$

${ROWSPAN2}$Latin + 斯拉夫文${REMOVE}$

使用斯拉夫小字母 O

U+f000

0

Zzzz;

已取消指派

U+f000

GSS_ALLOW_INHERITED_COMMON

Zzzz;

已取消指派

 

必要的頭檔與 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)

DownlevelGetLocaleScripts

DownlevelVerifyScripts

GetStringScripts