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