Compartir a través de

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

  • Artículo

Establece el nombre descriptivo del cliente.

Sintaxis

HRESULT put_ClientName(
  [in] BSTR value
);

Parámetros

[in] value

Nombre de la aplicación cliente.

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_INVALIDARG
 Uno o varios argumentos no son válidos.

Valor: 0x80070057

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 borrado 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 borrar el medio. El nombre está restringido al mismo juego de caracteres que requiere el código de control IOCTL_CDROM_EXCLUSIVE_ACCESS.

Requisitos

   
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

IDiscFormat2Erase

IDiscFormat2Erase::get_ClientName