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 が返された文字列に追加される。

参照

• エラー コードと成功コード
• IDvdInfo2 インターフェイス
• DVD テキスト文字列の操作