Compartilhar via


Método IDiscRecorder::GetRecorderProperties (imapi.h)

Recupera um ponteiro para uma interface IPropertyStorage .

Sintaxe

HRESULT GetRecorderProperties(
  [out] IPropertyStorage **ppPropStg
);

Parâmetros

[out] ppPropStg

Ponteiro para uma interface IPropertyStorage para o conjunto de propriedades com todas as propriedades atuais definidas.

Retornar valor

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

As propriedades não são retidas depois que o IMAPI é fechado. Um formato de conjunto de propriedades é conveniente para IMAPI porque armazena uma combinação ID/TYPE/VALUE, bem como associações de ID/NOME. Cada combinação é uma única propriedade, e o IMAPI usa essas propriedades para vários valores exclusivos de gravadores específicos. Por exemplo, a maioria dos gravadores seria compatível com uma propriedade WriteSpeed.

Em seguida, o chamador pode modificar as propriedades chamando SetRecorderProperties. As propriedades atuais incluem o seguinte:

Requisitos

Requisito Valor
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

Confira também

IDiscRecorder

IPropertyStorage