estructura ATOMIC_CREATE_ECP_CONTEXT (ntifs.h)

La estructura ATOMIC_CREATE_ECP_CONTEXT contiene el contexto del parámetro de creación adicional (ECP) que permite realizar operaciones complementarias en un archivo de forma atómica durante la creación.

Sintaxis

typedef struct _ATOMIC_CREATE_ECP_CONTEXT {
  USHORT               Size;
  USHORT               InFlags;
  USHORT               OutFlags;
  USHORT               ReparseBufferLength;
  PREPARSE_DATA_BUFFER ReparseBuffer;
  LONGLONG             FileSize;
  LONGLONG             ValidDataLength;
  PFILE_TIMESTAMPS     FileTimestamps;
  ULONG                FileAttributes;
  ULONG                UsnSourceInfo;
  USN                  Usn;
  ULONG                SuppressFileAttributeInheritanceMask;
  ULONG                InOpFlags;
  ULONG                OutOpFlags;
  ULONG                InGenFlags;
  ULONG                OutGenFlags;
  ULONG                CaseSensitiveFlagsMask;
  ULONG                InCaseSensitiveFlags;
  ULONG                OutCaseSensitiveFlags;
} ATOMIC_CREATE_ECP_CONTEXT, *PATOMIC_CREATE_ECP_CONTEXT;

Miembros

Size

Tamaño de esta estructura de contexto, en bytes.

InFlags

Marcas que indican las operaciones complementarias solicitadas que se van a realizar con la operación de creación.

OutFlags

Marcas que indican las operaciones complementarias reales realizadas con una operación de creación correcta.

ReparseBufferLength

Longitud del miembro ReparseBuffer . Este valor no puede superar el MAXIMUM_REPARSE_DATA_BUFFER_SIZE (16 000).

ReparseBuffer

Valor opcional que indica el tipo de búfer usado en la operación de creación. Los valores posibles son REPARSE_DATA_BUFFER o REPARSE_GUID_DATA_BUFFER.

FileSize

Valor opcional que se usa con ATOMIC_CREATE_ECP_IN_FLAG_EOF_SPECIFIED para indicar el tamaño de archivo solicitado que se va a establecer en el archivo.

ValidDataLength

Valor opcional que se usa con ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED para indicar la longitud de datos válida solicitada que se va a establecer en el archivo.

FileTimestamps

Puntero a una estructura de FILE_TIMESTAMPS opcional que contiene la última instancia registrada de acciones específicas en un archivo.

FileAttributes

Especifica los atributos de un archivo.

UsnSourceInfo

Especifica marcas de información de origen opcionales del número de secuencia de actualización (USN).

Usn

Especifica el número de secuencia de actualización (USN). Este valor se rellena al final de GUID_ECP_ATOMIC_CREATE .

SuppressFileAttributeInheritanceMask

Máscara que indica los atributos de archivo cuyas reglas de herencia normales deben suprimirse.

InOpFlags

ATOMIC_CREATE_ECP_IN_OP_FLAG_xxx marcas.

OutOpFlags

ATOMIC_CREATE_ECP_OUT_OP_FLAG_xxx marcas.

InGenFlags

ATOMIC_CREATE_ECP_IN_GN_FLAG_xxx marcas.

OutGenFlags

marcas de ATOMIC_CREATE_ECP_OUT_GN_FLAG_xxx.

CaseSensitiveFlagsMask

Indica qué marcas de FILE_CS_FLAG_xxx se especifican; Los sistemas de archivos deben elegir los valores predeterminados para otras marcas.

InCaseSensitiveFlags

Marcas que distinguen mayúsculas de minúsculas en el archivo. Incluso si no se especifica ningún BEST_EFFORT, los sistemas de archivos pueden omitir algunos de los inCaseSensitiveFlags. El comportamiento es similar a FileCaseSensitiveInformation, por lo que los autores de llamadas podrían examinar OutCaseSensitiveFlags para conocer las marcas establecidas. Si no se admite una marca en algún archivo o directorio, BEST_EFFORT surtiría efecto.

OutCaseSensitiveFlags

Este miembro devuelve las marcas que distinguen mayúsculas de minúsculas en el archivo, incluso si no se especifican inCaseSensitiveFlags .

Comentarios

El valor de GUID_ECP_ATOMIC_CREATE** definido por el sistema se usa con esta estructura de contexto ECP al llamar a rutinas de soporte técnico relacionadas con ECP, como FltAllocateExtraCreateParameter y FsRtlRemoveExtraCreateParameter.

Consulte Introducción a los parámetros de creación adicionales para obtener más información.

Requisitos