IFsiFileItem2 ::p ut_IsRealTime, méthode (imapi2fs.h)
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 |
|---|---|
|
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. |
|
Propriété '%1 !ls !' n’est pas accessible. |
|
Valeur spécifiée pour le paramètre '%1 !ls !' est non valide. |
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 |