структура NETWORK_OPEN_ECP_CONTEXT (ntifs.h)
Структура NETWORK_OPEN_ECP_CONTEXT используется для интерпретации контекстов дополнительных параметров создания сети (ECP) в файлах.
Синтаксис
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;
Члены
Size
Размер этой структуры в байтах.
Reserved
Скрытный. Должно быть задано равно нулю.
DUMMYSTRUCTNAME
Структура, содержащая ограничения для открытия файла (предварительного создания) и применения к файлу после его открытия (после создания).
DUMMYSTRUCTNAME.in
Структура, содержащая предварительно созданные ограничения для открытия файла.
DUMMYSTRUCTNAME.in.Location
Значение NETWORK_OPEN_LOCATION_QUALIFIERтипа, указывающее ограничение расположения для присоединения к файлу.
DUMMYSTRUCTNAME.in.Integrity
Значение NETWORK_OPEN_INTEGRITY_QUALIFIERтипа, указывающее ограничение целостности для присоединения к файлу.
DUMMYSTRUCTNAME.in.Flags
Поддерживается начиная с Windows 7. Значение, указывающее атрибуты для файла. Этот элемент является битовой или любой из следующих флагов.
| Ценность | Значение |
|---|---|
| NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1) | Указывает на перенаправление SMB, что входящий открытый запрос не должен быть piggybacked и свернут на существующий открытый дескриптор в тот же файл. |
| NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2) | Приводит к отключению устойчивости на этом открытом дескрипторе SMB2+ перенаправления. Дополнительные сведения о открытии файла для устойчивой операции см. в запросах приложений, которые создают файл, открытый для устойчивых операций. |
| NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4) | Указывает на перенаправление SMB, чтобы не предоставлять оплоки для входящего открытого запроса. Этот флаг доступен начиная с Windows 8. |
| NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000) | Зарезервировано для внутреннего использования и не должно использоваться приложениями. Этот флаг заставляет перенаправление использовать синхронный ввод-вывод, даже если дескриптор был открыт для асинхронного ввода-вывода. |
DUMMYSTRUCTNAME.out
Структура, содержащая ограничения после создания файла после его открытия.
DUMMYSTRUCTNAME.out.Location
Значение NETWORK_OPEN_LOCATION_QUALIFIERтипа, указывающее ограничение расположения для присоединения к файлу.
DUMMYSTRUCTNAME.out.Integrity
Значение NETWORK_OPEN_INTEGRITY_QUALIFIERтипа, указывающее ограничение целостности для присоединения к файлу.
DUMMYSTRUCTNAME.out.Flags
Поддерживается начиная с Windows 7. Значение, указывающее атрибуты для файла. Этот элемент является битовой или любой из следующих флагов.
| Ценность | Значение |
|---|---|
| NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1) | Указывает на перенаправление SMB, что входящий открытый запрос не должен быть piggybacked и свернут на существующий открытый дескриптор в тот же файл. |
| NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2) | Приводит к отключению устойчивости на этом открытом дескрипторе SMB2+ перенаправления. Дополнительные сведения о открытии файла для устойчивой операции см. в запросах приложений, которые создают файл, открытый для устойчивых операций. |
| NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000) | Зарезервировано для внутреннего использования и не должно использоваться приложениями. Этот флаг заставляет перенаправление использовать синхронный ввод-вывод, даже если дескриптор был открыт для асинхронного ввода-вывода. |
Замечания
Сведения об использовании ECP для связывания дополнительных сведений с файлом при создании файла см. в разделе Использование дополнительных параметров создания с IRP_MJ_CREATE операцией.
Драйвер фильтра должен учитывать структуру NETWORK_OPEN_ECP_CONTEXT только для чтения, используя ее только для получения сведений о контексте ECP сети в файле. Дополнительные сведения см. в System-DefinedECP.
Если вызывающий объект должен убедиться, что файловая система признала структуру контекста NETWORK_OPEN_ECP_CONTEXT, вызывающий объект должен вызвать FltIsEcpAcknowlededed или FsRtlIsEcpAcknowled подпрограммы в ECP после завершения операции.
Драйверы, которые работают в Windows 7 и более поздних версиях Windows, и которые должны интерпретировать контексты ECP сети в файлах, которые находятся в Windows Vista, должны использовать вместо этого структуру NETWORK_OPEN_ECP_CONTEXT_V0.
Драйверы, которые работают в Windows Vista и более поздних версиях Windows, используют структуру NETWORK_OPEN_ECP_CONTEXT для интерпретации контекстов ECP сети в файлах. Однако DUMMYSTRUCTNAME.in.Flags и DUMMYSTRUCTNAME.out.Flags поддерживаются только с Windows 7.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Эта структура доступна начиная с Windows Vista. |
| заголовка | ntifs.h (include Ntifs.h) |