Método IDiscRecorder::SetRecorderProperties (imapi.h)
Acepta un puntero IPropertyStorage para un objeto con todas las propiedades que la aplicación desea cambiar. Se admiten configuraciones dispersas. Sin embargo, se recomienda consultar un conjunto de propiedades mediante GetRecorderProperties, modificar solo la configuración de interés y, a continuación, llamar a SetRecorderProperties para cambiar todos los valores simultáneamente.
Sintaxis
HRESULT SetRecorderProperties(
[in] IPropertyStorage *pPropStg
);
Parámetros
[in] pPropStg
Puntero a la interfaz IPropertyStorage que la grabadora de discos puede usar para recuperar nuevas configuraciones en varias propiedades.
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:
Comentarios
Algunas propiedades son de solo lectura, como MaxWriteSpeed. Tanto las propiedades de solo lectura como las propiedades no admitidas se omiten sin generar un error (consulte IMAPI_S_PROPERTIESIGNORED). Por ejemplo, alguien podría enviar una propiedad establecida en esta interfaz e intentar cambiar las propiedades MaxWriteSpeed y ClearlyNeverHeardOfBefore. Dado que MaxWriteSpeed es de solo lectura y ClearlyNeverHeardOfBefore es un valor desconocido, ambas propiedades se omiten y el método se realiza correctamente.
Después de llamar a SetRecorderProperties, una aplicación debe comprobar la configuración de propiedades llamando a GetRecorderProperties.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi.h |
| Library | Uuid.lib |
| Archivo DLL | Actxprxy.dll |