структура 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 сети в файле. Дополнительные сведения см. в System-DefinedECP.
Если вызывающий объект должен убедиться, что файловая система признала структуру контекста NETWORK_OPEN_ECP_CONTEXT_V0, вызывающий объект должен вызвать FltIsEcpAcknowleded или FsRtlIsEcpAcknowleded подпрограммы в ECP после завершения операции.
В большинстве случаев драйверы, которые работают в Windows Vista и более поздних версиях Windows, используют структуру NETWORK_OPEN_ECP_CONTEXT для интерпретации контекстов ECP сети в файлах. Однако драйверы, которые работают в Windows 7 и более поздних версиях Windows, и которые должны интерпретировать контексты ECP сети в файлах, находящихся в Windows Vista, должны использовать вместо этого структуру NETWORK_OPEN_ECP_CONTEXT_V0.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Эта структура доступна начиная с Windows 7. |
| заголовка | ntifs.h (include Ntifs.h) |