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