通过

IDiscFormat2TrackAtOnce：:p ut_ClientName 方法 (imapi2.h)

  • 项目

设置客户端的友好名称。

语法

HRESULT put_ClientName(
  [in] BSTR value
);

parameters

[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 驱动程序开发工具包 (DDK) ) 来访问名称，因此，名称必须标识使用此接口写入媒体的程序。 该名称仅限于IOCTL_CDROM_EXCLUSIVE_ACCESS控制代码所需的相同字符集。

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce：：get_ClientName