次の方法で共有


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

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

構文

HRESULT put_ClientName(
  [in] BSTR value
);

パラメーター

[in] value

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

戻り値

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

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

値: 0x8007000E

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

値: 0xC0AA0604

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

値: 0xC0AA0600

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

値: 0xC0AA0603

注釈

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

こちらもご覧ください

IDiscFormat2RawCD

IDiscFormat2RawCD::get_ClientName