estructura NETWORK_OPEN_ECP_CONTEXT (ntifs.h)

Artículo
02/26/2024

La estructura NETWORK_OPEN_ECP_CONTEXT se usa para interpretar contextos de parámetros de creación adicionales (ECP) de red en archivos.

Sintaxis

typedef struct _NETWORK_OPEN_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_IN_FLAGS            Flags;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_OUT_FLAGS           Flags;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT, *PNETWORK_OPEN_ECP_CONTEXT;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Reserved

Reservado. Debe establecerse en cero.

DUMMYSTRUCTNAME

Estructura que contiene restricciones que se deben aplicar para abrir el archivo (crear previamente) y aplicarlo al archivo después de abrirlo (posterior a la creación).

DUMMYSTRUCTNAME.in

Estructura que contiene restricciones previas a la creación para abrir un archivo.

DUMMYSTRUCTNAME.in.Location

Valor de tipo NETWORK_OPEN_LOCATION_QUALIFIER que especifica la restricción de ubicación que se va a adjuntar al archivo.

DUMMYSTRUCTNAME.in.Integrity

Valor de tipo NETWORK_OPEN_INTEGRITY_QUALIFIER que especifica la restricción de integridad que se va a adjuntar al archivo.

DUMMYSTRUCTNAME.in.Flags

Se admite a partir de Windows 7. Valor que especifica los atributos del archivo. Este miembro es un OR bit a bit de cualquiera de las marcas siguientes.

Valor	Significado
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indica al redirector SMB que la solicitud abierta entrante no debe estar contraída y contraída en un identificador abierto existente en el mismo archivo.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Hace que el redirector de SMB2+ deshabilite la durabilidad en este identificador abierto. Para obtener más información sobre cómo abrir un archivo para una operación duradera, vea Solicitudes de aplicación que crean un archivo abierto para la operación durable.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Indica al redirector de SMB para que no conceda interbloqueos para la solicitud abierta entrante. Esta marca está disponible a partir de Windows 8.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reservado para uso interno y no debe ser utilizado por las aplicaciones. Esta marca obliga al redirector a usar E/S sincrónica aunque el identificador se abrió para E/S asincrónica.

DUMMYSTRUCTNAME.out

Estructura que contiene restricciones posteriores a la creación para aplicar a un archivo después de que se haya abierto.

DUMMYSTRUCTNAME.out.Location

Valor de tipo NETWORK_OPEN_LOCATION_QUALIFIER que especifica la restricción de ubicación que se va a adjuntar al archivo.

DUMMYSTRUCTNAME.out.Integrity

Valor de tipo NETWORK_OPEN_INTEGRITY_QUALIFIER que especifica la restricción de integridad que se va a adjuntar al archivo.

DUMMYSTRUCTNAME.out.Flags

Se admite a partir de Windows 7. Valor que especifica los atributos del archivo. Este miembro es un OR bit a bit de cualquiera de las marcas siguientes.

Valor	Significado
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indica al redirector SMB que la solicitud abierta entrante no debe estar contraída y contraída en un identificador abierto existente en el mismo archivo.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Hace que el redirector de SMB2+ deshabilite la durabilidad en este identificador abierto. Para obtener más información sobre cómo abrir un archivo para una operación duradera, vea Solicitudes de aplicación que crean un archivo abierto para la operación durable.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reservado para uso interno y no debe ser utilizado por las aplicaciones. Esta marca obliga al redirector a usar E/S sincrónica aunque el identificador se abrió para E/S asincrónica.

Comentarios

Para obtener información sobre cómo usar ECP para asociar información adicional a un archivo cuando se crea el archivo, vea Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

Un controlador de filtro debe considerar que la estructura de NETWORK_OPEN_ECP_CONTEXT sea de solo lectura, usándola solo para recuperar información sobre el contexto ecp de red en un archivo. Para obtener más información, consulte ECP definidas por el sistema.

Si un llamador debe comprobar que el sistema de archivos reconoció la estructura de contexto de NETWORK_OPEN_ECP_CONTEXT , el autor de la llamada debe llamar a la rutina FltIsEcpAcknowledged o FsRtlIsEcpAcknowledged en el ECP una vez completada la operación.

Los controladores que se ejecutan en Windows 7 y versiones posteriores de Windows y que deben interpretar contextos ecp de red en archivos que residen en Windows Vista deben usar la estructura NETWORK_OPEN_ECP_CONTEXT_V0 en su lugar.

Los controladores que se ejecutan en Windows Vista y versiones posteriores de Windows usan la estructura NETWORK_OPEN_ECP_CONTEXT para interpretar los contextos ecp de red en los archivos. Sin embargo, los miembros DUMMYSTRUCTNAME.in.Flags y DUMMYSTRUCTNAME.out.Flags solo se admiten a partir de Windows 7.