Método IDiscFormat2RawCD::p ut_ClientName (imapi2.h)

Establece el nombre descriptivo del cliente.

Sintaxis

HRESULT put_ClientName(
  [in] BSTR value
);

Parámetros

[in] value

Nombre de la aplicación cliente. No puede ser NULL ni una cadena vacía.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto	Descripción
E_OUTOFMEMORY	No se pudo asignar la memoria necesaria. Valor: 0x8007000E
E_IMAPI_DF2RAW_CLIENT_NAME_IS_NOT_VALID	El nombre de cliente no es válido. Valor: 0xC0AA0604
E_IMAPI_DF2RAW_WRITE_IN_PROGRESS	Actualmente hay una operación de escritura en curso. Valor: 0xC0AA0600
E_IMAPI_DF2RAW_MEDIA_IS_PREPARED	La operación solicitada no es válida cuando el medio se ha "preparado", pero no se ha liberado. Valor: 0xC0AA0603

Comentarios

El nombre se usa cuando la operación de escritura solicita acceso exclusivo al dispositivo. La propiedad IDiscRecorder2::get_ExclusiveAccessOwner contiene el nombre del cliente que tiene el bloqueo.

Dado que cualquier aplicación con acceso de lectura y escritura al dispositivo CDROM durante la operación de escritura puede usar el código de control de IOCTL_CDROM_EXCLUSIVE_ACCESS (consulta) (vea el Kit de desarrollo de controladores de Microsoft Windows (DDK)) para acceder al nombre, es importante que el nombre identifique el programa que usa esta interfaz para escribir en el medio. El nombre está restringido al mismo juego de caracteres que requiere el código de control IOCTL_CDROM_EXCLUSIVE_ACCESS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	imapi2.h

Consulte también

IDiscFormat2RawCD

IDiscFormat2RawCD::get_ClientName