Método IDiscRecorder::SetRecorderProperties (imapi.h)
Aceita um ponteiro IPropertyStorage para um objeto com todas as propriedades que o aplicativo deseja alterar. Há suporte para configurações esparsas. No entanto, é recomendável consultar um conjunto de propriedades usando GetRecorderProperties, modificar apenas essas configurações de interesse e, em seguida, chamar SetRecorderProperties para alterar todos os valores simultaneamente.
Sintaxe
HRESULT SetRecorderProperties(
[in] IPropertyStorage *pPropStg
);
Parâmetros
[in] pPropStg
Ponteiro para a interface IPropertyStorage que o gravador de discos pode usar para recuperar novas configurações em várias propriedades.
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
Algumas propriedades são somente leitura, como MaxWriteSpeed. As propriedades somente leitura e as propriedades sem suporte são ignoradas sem gerar um erro (consulte IMAPI_S_PROPERTIESIGNORED). Por exemplo, alguém pode enviar um conjunto de propriedades para essa interface e tentar alterar as propriedades MaxWriteSpeed e ClearlyNeverHeardOfBefore. Como MaxWriteSpeed é somente leitura e ClearlyNeverHeardOfBefore é um valor desconhecido, ambas as propriedades são ignoradas e o método é bem-sucedido.
Depois de chamar SetRecorderProperties, um aplicativo deve verificar as configurações de propriedade chamando GetRecorderProperties.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi.h |
| Biblioteca | Uuid.lib |
| DLL | Actxprxy.dll |