GetStringTypeW

指定した Unicode ソース文字列内の文字の文字種情報を取得する。

GetStringTypeW dwInfoType, lpSrcStr, cchSrc, lpCharType

dwInfoType : [int] 取得する文字種情報を指定するフラグ。このパラメータには以下の値を指定できる。文字種は備考セクションで説明する異なるレベルに分割される。
lpSrcStr : [wstr] 文字種を取得する Unicode 文字列へのポインタ。cchSrc が任意の負の値に設定されている場合、文字列は null 終端されているとみなされる。
cchSrc : [int] lpSrcStr が示す文字列のサイズ（文字数）。サイズに終端 null 文字が含まれている場合、関数はその文字に対する文字種情報を取得する。アプリケーションがサイズを負の整数に設定した場合、ソース文字列は null 終端されているとみなされ、関数は null 終端のための追加文字とともに自動的にサイズを計算する。
lpCharType : [var] 16 ビット値の配列へのポインタ。この配列の長さは、ソース文字列の各文字に対して 1 つの 16 ビット値を受け取るのに十分な大きさでなければならない。cchSrc が負の数でない場合、lpCharType は cchSrc 個の要素を持つワード配列であるべきである。cchSrc が負の数に設定されている場合、lpCharType は lpSrcStr + 1 個の要素を持つワード配列となる。関数が戻ったとき、この配列にはソース文字列の各文字に対応する 1 つのワードが含まれる。

(プラグイン / モジュール : kernel32.dll)

解説

指定した Unicode ソース文字列内の文字の文字種情報を取得する。

[戻り値]
成功した場合は 0 以外、それ以外の場合は 0 を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶ。これは以下のいずれかのエラーコードを返す。
（以下省略）

[備考]
文字列関数の使用の概要については Strings を参照。lpSrcStr と lpCharType
パラメータの値は同じであってはならない。同じである場合、関数は ERROR_INVALID_PARAMETER で失敗する。対応する
GetStringTypeA 関数で使用される Locale
パラメータはこの関数では使用されない。パラメータの違いのため、アプリケーションは #define UNICODE スイッチを使用して
GetStringType* 関数の適切な ANSI または Unicode
版を自動的に呼び出すことができない。アプリケーションは推奨関数である GetStringTypeEx
を使用してこの制限を回避できる。サポートされる文字種 文字種ビットはいくつかのレベルに分割される。1
つのレベルの情報はこの関数の単一の呼び出しで取得できる。各レベルは 16 ビットの情報に制限されており、文字あたり 16
ビット表現に制限される他のマッピング関数も文字種情報を返せるようになっている。Ctype 1 これらの種別は ANSI C と POSIX
(LC_CTYPE) 文字型関数をサポートする。dwInfoType が CT_CTYPE1 に設定されている場合、これらの値のビット単位
OR が出力バッファ内の配列に取得される。DBCS
ロケールの場合、種別属性はナロー文字とワイド文字の両方に適用される。日本語のひらがなとカタカナの文字、漢字の表意文字はすべて
C1_ALPHA 属性を持つ。
（以下省略）

情報