IDiscFormat2RawCD::p ut_ClientName メソッド (imapi2.h)
クライアントのフレンドリ名を設定します。
構文
HRESULT put_ClientName(
[in] BSTR value
);
パラメーター
[in] value
クライアント アプリケーションの名前。 NULL または空の文字列にすることはできません。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
リターン コード | 説明 |
---|---|
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
|
クライアント名が無効です。
値: 0xC0AA0604 |
|
現在、書き込み操作が進行中です。
値: 0xC0AA0600 |
|
メディアが "準備済み" でリリースされていない場合、要求された操作は無効です。
値: 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 |