estructura ECP_OPEN_PARAMETERS (ntifs.h)
La estructura ECP_OPEN_PARAMETERS contiene el contexto de parámetros de creación adicional (ECP) que permite a un autor de llamada especificar el propósito de abrir un archivo sin interferir con los identificadores existentes o bloqueos oportunistas (oplocks) en el archivo.
Sintaxis
typedef struct _ECP_OPEN_PARAMETERS {
USHORT Size;
USHORT Reserved;
ULONG Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;
Miembros
Size
Especifica el tamaño de esta estructura de contexto, en bytes.
Reserved
Reservado para uso futuro. Debe inicializarse en 0.
Flags
Marcas que especifican los parámetros o propósitos para abrir un archivo. Las marcas pueden ser cualquier combinación de los valores siguientes:
| Valor | Descripción |
|---|---|
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) | Abrir el archivo para leerlo. |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) | Abrir archivo para escribir en él. |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) | Abrir el archivo para eliminarlo. |
| ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) | Fuerza una búsqueda sin distinción entre mayúsculas y minúsculas para este archivo abierto, incluso en un directorio que distingue mayúsculas de minúsculas. Disponible a partir de Windows 10, versión 2004. |
| ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) | Se produce un error en el archivo abierto o en la solicitud de creación si la ruta de acceso tiene directorios que distinguen mayúsculas de minúsculas. Disponible a partir de Windows 10, versión 2004. |
Comentarios
Las marcas de ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ y ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE permiten el acceso de lectura y escritura a archivos cifrados sin tener que abrir estos archivos para el acceso de lectura y escritura. Estas marcas ECP permiten que un componente en modo kernel se abra para el acceso de solo metadatos, por lo que no interfiere con otro acceso mientras sigue obteniendo la configuración del contexto de cifrado para realizar lecturas y escrituras. Un filtro puede establecer estas marcas para evitar conflictos con el bloqueo. La configuración del estado de cifrado para las operaciones de lectura y escritura es costosa y no suele realizarse cuando los archivos no se abren para el acceso de lectura y escritura.
El valor de GUID_ECP_OPEN_PARAMETERS definido por el sistema se usa con esta estructura de contexto ECP al llamar a rutinas de soporte 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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1709. |
| Encabezado | ntifs.h (incluya Ntifs.h) |