Compartilhar via


Método IFsiFileItem2::p ut_IsRealTime (imapi2fs.h)

Define o atributo 'Tempo Real' de um arquivo em um sistema de arquivos. Esse atributo especifica se o conteúdo requer ou não uma taxa mínima de transferência de dados ao gravar ou ler, por exemplo, dados de áudio e vídeo.

Sintaxe

HRESULT put_IsRealTime(
  [in] VARIANT_BOOL newVal
);

Parâmetros

[in] newVal

Especifique VARIANT_TRUE para definir o atributo Real-Time de um arquivo na imagem do sistema de arquivos; caso contrário, VARIANT_FALSE. O padrão é VARIANT_FALSE.

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 geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Valor/código retornado Descrição
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
Valor: 0x00AAB15FL
Não há suporte para o recurso para a revisão atual do sistema de arquivos e, como resultado, o arquivo foi marcado como Real-Time mas não aparecerá como tal na imagem do sistema de arquivos resultante, a menos que a revisão 2.01 ou superior da UDF esteja habilitada no objeto do sistema de arquivos.
IMAPI_E_PROPERTY_NOT_ACCESSIBLE
Valor: 0xC0AAB160L
Propriedade '%1!ls!' não está acessível.
IMAPI_E_INVALID_PARAM
Valor: 0xC0AAB101
O valor especificado para o parâmetro '%1!ls!' será inválido.
 
Nota Atualmente, S_OK é retornado ao usar esse método para definir um valor de atributo Real-Time de um arquivo que é "Somente Leitura" como resultado de uma operação CreateResultImage bem-sucedida.
 

Comentários

Os métodos IFsiDirectoryItem::AddTree e IFsiDirectoryItem2::AddTreeWithNamedStreams não definem o atributo Real-Time ao adicionar arquivos a uma imagem do sistema de arquivos. Para marcar arquivos como arquivos em tempo real, eles devem ser enumerados depois de serem adicionados à imagem do sistema de arquivos e ter o atributo Real-Time definido individualmente.

Se esse método for invocado para um item de arquivo que representa um fluxo nomeado, esse método retornará o código de erro IMAPI_E_PROPERTY_NOT_ACCESSIBLE , pois os fluxos nomeados não têm o atributo Real-Time.

Esse método tem suporte no Windows Server 2003 com Service Pack 1 (SP1), Windows XP com Service Pack 2 (SP2) e Windows Vista por meio do Pacote de Recursos do Windows para Armazenamento. Todos os recursos fornecidos por este pacote de atualização têm suporte nativo no Windows 7 e no Windows Server 2008 R2.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [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 imapi2fs.h

Confira também

IFsiFileItem2