estructura NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

Artículo
12/22/2024

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

Sintaxis

typedef struct _NETWORK_OPEN_ECP_CONTEXT_V0 {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT_V0, *PNETWORK_OPEN_ECP_CONTEXT_V0;

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_QUALIFIERque especifica la restricción de ubicación que se va a adjuntar al archivo.

DUMMYSTRUCTNAME.in.Integrity

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

DUMMYSTRUCTNAME.out

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

DUMMYSTRUCTNAME.out.Location

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

DUMMYSTRUCTNAME.out.Integrity

Este miembro no está implementado actualmente y debe omitirse.

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

Observaciones

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 System-Defined ECPs.

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

En la mayoría de los casos, los controladores que se ejecutan en Windows Vista y versiones posteriores de Windows usan la estructura de NETWORK_OPEN_ECP_CONTEXT para interpretar los contextos de ECP de red en los archivos. Sin embargo, 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 de NETWORK_OPEN_ECP_CONTEXT_V0 en su lugar.