Metodo IFsiFileItem2::p ut_IsRealTime (imapi2fs.h)

Articolo
03/14/2023

Imposta l'attributo 'Real-Time' di un file in un file system. Questo attributo specifica se il contenuto richiede una velocità di trasferimento dati minima durante la scrittura o la lettura, ad esempio dati audio e video.

Sintassi

HRESULT put_IsRealTime(
  [in] VARIANT_BOOL newVal
);

Parametri

[in] newVal

Specificare VARIANT_TRUE per impostare l'attributo Real-Time di un file nell'immagine del file system; in caso contrario, VARIANT_FALSE. Il valore predefinito è VARIANT_FALSE.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice/valore restituito	Descrizione
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED Valore: 0x00AAB15FL	La funzionalità non è supportata per la revisione corrente del file system e, di conseguenza, il file è stato contrassegnato come Real-Time ma non verrà visualizzato come tale nell'immagine del file system risultante, a meno che la revisione UDF 2.01 o successiva sia abilitata nell'oggetto file system.
IMAPI_E_PROPERTY_NOT_ACCESSIBLE Valore: 0xC0AAB160L	Proprietà '%1!ls!' non è accessibile.
IMAPI_E_INVALID_PARAM Valore: 0xC0AAB101	Valore specificato per il parametro '%1!ls!' non è valido.

Nota Attualmente, S_OK viene restituito quando si usa questo metodo per impostare un valore di attributo Real-Time di un file che è "Sola lettura" in seguito a un'operazione CreateResultImage riuscita.

Commenti

I metodi IFsiDirectoryItem::AddTree e IFsiDirectoryItem2::AddTreeWithNamedStreams non impostano l'attributo Real-Time durante l'aggiunta di file a un'immagine del file system. Per contrassegnare i file come file in tempo reale, è necessario enumerare dopo l'aggiunta all'immagine del file system e impostare singolarmente l'attributo Real-Time.

Se questo metodo viene richiamato per un elemento di file che rappresenta un flusso denominato, questo metodo restituisce il codice di errore IMAPI_E_PROPERTY_NOT_ACCESSIBLE come flussi denominati non dispone dell'attributo Real-Time.

Questo metodo è supportato in Windows Server 2003 con Service Pack 1 (SP1), Windows XP con Service Pack 2 (SP2) e Windows Vista tramite Windows Feature Pack per l'archiviazione. Tutte le funzionalità fornite da questo pacchetto di aggiornamento sono supportate in modo nativo in Windows 7 e Windows Server 2008 R2.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2fs.h

Vedi anche

IFsiFileItem2

Condividi tramite