次の方法で共有

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

  • [アーティクル]

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

構文

HRESULT put_ClientName(
  [in] BSTR value
);

パラメーター

[in] value

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

戻り値

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

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

値: 0x8007000E
E_IMAPI_DF2TAO_CLIENT_NAME_IS_NOT_VALID
 クライアント名が無効です。

値: 0xC0AA050F
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS
 書き込み操作が進行中です。

値: 0xC0AA0500
E_IMAPI_DF2TAO_MEDIA_IS_PREPARED
 メディアが "準備済み" でリリースされていない場合、要求された操作は無効です。

値: 0xC0AA0503

解説

この名前は、書き込み操作がデバイスへの排他アクセスを要求するときに使用されます。 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

関連項目

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::get_ClientName