IDiscFormat2Erase::p ut_ClientName メソッド (imapi2.h)

クライアントのフレンドリ名を設定します。

構文

HRESULT put_ClientName(
  [in] BSTR value
);

パラメーター

[in] value

クライアント アプリケーションの名前。

戻り値

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

リターン コード	説明
E_OUTOFMEMORY	必要なメモリを割り当てませんでした。 値: 0x8007000E
E_INVALIDARG	1 つ以上の引数が無効です。 値: 0x80070057

解説

この名前は、書き込み操作がデバイスへの排他アクセスを要求するときに使用されます。 IDiscRecorder2::get_ExclusiveAccessOwner プロパティには、ロックを持つクライアントの名前が含まれています。

消去操作中に CDROM デバイスへの読み取り/書き込みアクセス権を持つアプリケーションは、IOCTL_CDROM_EXCLUSIVE_ACCESS (クエリ) コントロール コード (Microsoft Windows Driver Development Kit (DDK) を参照) を使用して名前にアクセスできるため、このインターフェイスを使用してメディアに消去するプログラムを名前で識別することが重要です。 名前は、IOCTL_CDROM_EXCLUSIVE_ACCESS コントロール コードで必要なのと同じ文字セットに制限されます。

要件

サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	imapi2.h

関連項目

IDiscFormat2Erase

IDiscFormat2Erase::get_ClientName