Compartir a través de

Método IDiscFormat2Data::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. 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 códigos de error siguientes 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_DF2DATA_CLIENT_NAME_IS_NOT_VALID
 El nombre del cliente no es válido.

Valor: 0xC0AA0211
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS
 Actualmente hay una operación de escritura en curso.

Valor: 0xC0AA0500

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) (consulte el Kit de desarrollo de controladores de Microsoft Windows (DDK)) para tener acceso 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

IDiscFormat2Data

IDiscFormat2Data::get_ClientName