IDvdInfo2::GetDVDTextStringAsUnicode
GetDVDTextStringAsUnicode メソッドは、指定された言語と文字列インデックスのテキスト文字列を Unicode™ で取得する。
構文
HRESULT GetDVDTextStringAsUnicode(
ULONG ulLangIndex,
ULONG ulStringIndex,
TCHAR *pchBuffer,
ULONG ulMaxBufferSize,
ULONG *pulActualSize,
enum DVD_TextStringType *pType
);
パラメータ
ulLangIndex
[in] 言語インデックス。
ulStringIndex
[in] 特定の言語の文字列インデックス。
pchBuffer
[out] テキスト文字列を受け取るバッファへのポインタ。pchBuffer が NULL の場合、このメソッドは pulActualSize によって文字列のサイズのみを返す。
ulMaxBufferSize
[in] sizeof(pchBuffer)/sizeof(*pchBuffer) によって計算される許容最大文字列サイズ。
pulActualSize
[out] pchBuffer によって返される、最後の NULL を含む文字列の実際の長さを受け取る ULONG 型の変数へのポインタ。
pType
[out] 返された文字列データの種類を受け取る DVD_TextStringType 列挙型の変数へのポインタ。
戻り値
次のいずれかの HRESULT 値を返す。
戻りコード | 説明 |
S_OK | 成功。 |
E_POINTER | 無効な引数。 |
E_UNEXPECTED | 予期しない内部エラーが発生した。 |
注意
一般的に、堅牢なアプリケーションは Unicode™ 文字列を処理できる。したがって、通常、文字列を取得するときは、まず GetDVDTextStringAsUnicodeを呼び出す。しかし、一部の文字列には Unicode で表せない文字が含まれていることがあるため、GetDVDTextStringAsUnicode が失敗した場合、アプリケーションは GetDVDTextStringAsNative を呼び出すことができる。
最後の NULL が返された文字列に追加される。
参照