IFsiFileItem2 ::p ut_IsRealTime, méthode (imapi2fs.h)

Article
02/27/2024

Définit l’attribut « Temps réel » d’un fichier dans un système de fichiers. Cet attribut spécifie si le contenu nécessite un taux minimal de transfert de données lors de l’écriture ou de la lecture, par exemple, des données audio et vidéo.

Syntaxe

HRESULT put_IsRealTime(
  [in] VARIANT_BOOL newVal
);

Paramètres

[in] newVal

Spécifiez VARIANT_TRUE pour définir l’attribut Real-Time d’un fichier dans l’image du système de fichiers ; sinon, VARIANT_FALSE. La valeur par défaut est VARIANT_FALSE.

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code/valeur de retour	Description
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED Valeur : 0x00AAB15FL	La fonctionnalité n’est pas prise en charge pour la révision actuelle du système de fichiers et, par conséquent, le fichier a été marqué comme Real-Time mais n’apparaîtra pas comme tel dans l’image de système de fichiers résultante, sauf si la révision UDF 2.01 ou ultérieure est activée dans l’objet système de fichiers.
IMAPI_E_PROPERTY_NOT_ACCESSIBLE Valeur : 0xC0AAB160L	Propriété '%1 !ls !' n’est pas accessible.
IMAPI_E_INVALID_PARAM Valeur : 0xC0AAB101	Valeur spécifiée pour le paramètre '%1 !ls !' est non valide.

Note Actuellement, S_OK est retourné lors de l’utilisation de cette méthode pour définir une valeur d’attribut Real-Time d’un fichier « Lecture seule » à la suite d’une opération CreateResultImage réussie.

Remarques

Les méthodes IFsiDirectoryItem ::AddTree et IFsiDirectoryItem2 ::AddTreeWithNamedStreams ne définissent pas l’attribut Real-Time lors de l’ajout de fichiers à une image de système de fichiers. Pour marquer les fichiers en tant que fichiers en temps réel, ils doivent être énumérés après avoir été ajoutés à l’image du système de fichiers et avoir l’attribut Real-Time défini individuellement.

Si cette méthode est appelée pour un élément de fichier représentant un flux nommé, cette méthode retourne le code d’erreur IMAPI_E_PROPERTY_NOT_ACCESSIBLE que les flux nommés n’ont pas l’attribut Real-Time.

Cette méthode est prise en charge dans Windows Server 2003 avec Service Pack 1 (SP1), Windows XP avec Service Pack 2 (SP2) et Windows Vista via le Feature Pack Windows pour le stockage. Toutes les fonctionnalités fournies par ce package de mise à jour sont prises en charge en mode natif dans Windows 7 et Windows Server 2008 R2.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imapi2fs.h

Voir aussi

IFsiFileItem2

Partager via