CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT structure (ntifs.h)

La structure CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT contient le contexte de paramètre de création supplémentaire (ECP) qui peut être envoyé au système de fichiers Volumes partagés de cluster (CSV) pour définir les propriétés de la façon dont il doit gérer les E/S arrivant sur cette ouverture.

Syntaxe

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

Membres

Size

Taille de cette structure, en octets.

PauseTimeoutInSeconds

Nombre de secondes pendant lesquelles CSVFS est autorisé à conserver les E/S émises sur cet objet fichier dans un état en attente en cas de pause du volume CSV. Une fois le délai d’expiration expiré, LE CSV termine toutes les E/S émises sur cet objet de fichier avec status STATUS_CSV_IO_PAUSE_TIMEOUT. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0xFFFFFFFF	Indique qu’il n’y a pas de délai d’expiration et que le comportement par défaut est demandé.
0	Csv ne suspend pas les E/S et termine les E/S immédiatement.
Toute autre valeur	CSV arrondit toutes les autres valeurs à un multiple de 10 secondes et utilise cette valeur comme délai d’expiration. La valeur de délai d’expiration maximale prise en charge est de 30 minutes. Si la valeur fournie est supérieure à 30 minutes, CSV définit silencieusement la valeur sur la valeur maximale.

Flags

Indicateurs de propriété set. Ce membre peut être un or au niveau du bit des indicateurs suivants.

Indicateur

Signification

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR

Indique à CSVFS que ce fichier ouvert doit être valide uniquement sur le nœud de coordination. Si l’ouverture arrive à CSVFS et que le nœud n’est pas un nœud de coordination, l’ouverture échoue. Si le fichier est ouvert et que le nœud de coordination est déplacé, le fichier ouvert est invalidé. Cet indicateur est utilisé uniquement lorsque le fichier est ouvert directement sur CSVFS et est ignoré lorsque le fichier est ouvert sur SMB.

Les 16 bits inférieurs d’indicateurs sont destinés aux indicateurs qui entraîneraient l’échec de la création avec STATUS_INVALID_PARAMETER si CSV ne les reconnaît pas. Les 16 bits supérieurs sont destinés aux indicateurs qui seraient ignorés silencieusement si CSVFS ne sait pas comment les gérer.

Remarques

La valeur de GUID_ECP_CSV_SET_HANDLE_PROPERTIES définie par le système est utilisée avec cette structure de contexte ECP lors de l’appel de routines de prise en charge liées à ECP telles que FltAllocateExtraCreateParameter et FsRtlRemoveExtraCreateParameter.

Pour plus d’informations, consultez Présentation des paramètres de création supplémentaires .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
En-tête	ntifs.h