Share via

структура NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

  • Статья

Структура NETWORK_OPEN_ECP_CONTEXT_V0 используется для интерпретации контекстов дополнительных параметров создания сети (ECP) в файлах.

Синтаксис

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;

Члены

Size

Размер данной структуры (в байтах).

Reserved

Зарезервировано. Необходимо задать нулевое значение.

DUMMYSTRUCTNAME

Структура , содержащая ограничения для открытия файла (предварительного создания) и применения к файлу после его открытия (после создания).

DUMMYSTRUCTNAME.in

Структура, содержащая предварительно созданные ограничения для открытия файла.

DUMMYSTRUCTNAME.in.Location

NETWORK_OPEN_LOCATION_QUALIFIER типизированное значение, указывающее ограничение расположения для присоединения к файлу.

DUMMYSTRUCTNAME.in.Integrity

NETWORK_OPEN_INTEGRITY_QUALIFIER типизированное значение, указывающее ограничение целостности для присоединения к файлу.

DUMMYSTRUCTNAME.out

Структура, содержащая ограничения после создания, применяемые к файлу после его открытия.

DUMMYSTRUCTNAME.out.Location

NETWORK_OPEN_LOCATION_QUALIFIER типизированное значение, указывающее ограничение расположения для присоединения к файлу.

DUMMYSTRUCTNAME.out.Integrity

Этот элемент в настоящее время не реализован и должен игнорироваться.

NETWORK_OPEN_INTEGRITY_QUALIFIER типизированное значение, указывающее ограничение целостности для присоединения к файлу.

Комментарии

Сведения о том, как использовать ecp для связывания дополнительных сведений с файлом при создании файла, см. в разделе Использование дополнительных параметров создания с операцией IRP_MJ_CREATE.

Драйвер фильтра должен считать структуру NETWORK_OPEN_ECP_CONTEXT доступной только для чтения, используя ее только для получения сведений о контексте ECP сети в файле. Дополнительные сведения см. в разделе Определяемые системой ESP.

Если вызывающий объект должен убедиться, что файловая система подтвердила NETWORK_OPEN_ECP_CONTEXT_V0 структуру контекста, вызывающий объект должен вызвать подпрограмму FltIsEcpAcknowledged или FsRtlIsEcpAcknowledged в ECP после завершения операции.

В большинстве случаев драйверы под управлением Windows Vista и более поздних версий Windows используют структуру NETWORK_OPEN_ECP_CONTEXT для интерпретации контекстов ECP сети в файлах. Однако драйверы, которые работают в Windows 7 и более поздних версиях Windows и должны интерпретировать контексты ECP сети для файлов, находящихся в Windows Vista, должны использовать структуру NETWORK_OPEN_ECP_CONTEXT_V0 .

Требования

Требование Значение
Минимальная версия клиента Эта структура доступна начиная с Windows 7.
Верхняя часть ntifs.h (включая Ntifs.h)

См. также раздел

FltIsEcpAcknowledged

FsRtlIsEcpAcknowledged

NETWORK_OPEN_ECP_CONTEXT

NETWORK_OPEN_INTEGRITY_QUALIFIER

NETWORK_OPEN_LOCATION_QUALIFIER