次の方法で共有


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

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

構文

HRESULT put_ClientName(
  [in] BSTR value
);

パラメーター

[in] value

クライアント アプリケーションの名前。 NULL または空の文字列にすることはできません。

戻り値

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

リターン コード 説明
E_OUTOFMEMORY
必要なメモリを割り当てませんでした。

値: 0x8007000E

E_IMAPI_DF2DATA_CLIENT_NAME_IS_NOT_VALID
クライアント名が無効です。

値: 0xC0AA0211

E_IMAPI_DF2DATA_WRITE_IN_PROGRESS
現在、書き込み操作が進行中です。

値: 0xC0AA0500

注釈

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

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

要件

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

こちらもご覧ください

IDiscFormat2Data

IDiscFormat2Data::get_ClientName