IDiscRecorder::GetDisplayNames メソッド (imapi.h)

表示できるレコーダーの書式設定された名前を取得します。名前は、デバイスの製造元と製品識別子で構成されます。

構文

HRESULT GetDisplayNames(
  [out] BSTR *pbstrVendorID,
  [out] BSTR *pbstrProductID,
  [out] BSTR *pbstrRevision
);

[out] pbstrVendorID

ディスクレコーダーのベンダー。このパラメーターは、NULL でもかまいません。

[out] pbstrProductID

ディスクレコーダーの製品名。このパラメーターは、NULL でもかまいません。

[out] pbstrRevision

ディスクレコーダーの改訂。これは通常、レコーダーファームウェアのリビジョンですが、デバイス全体のリビジョンにすることができます。このパラメーターは、NULL でもかまいません。

S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。次のエラーコードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

通常、表示名は、レコーダー選択リストボックスまたはその他の GUI コンポーネントに表示される文字列に結合されます。

これら 3 つの文字列の組み合わせでは、この特定のレコーダーの一意の識別子は生成されません。これらの文字列を GetPath から返される文字列と組み合わせて、一意の値を作成します。