структура NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)
Структура NETWORK_APP_INSTANCE_ECP_CONTEXT является дополнительным параметром создания (ECP) и содержит идентификатор экземпляра приложения для связывания с файлом. Эта структура используется для идентификации файлов, открытых для клиентского приложения отказоустойчивого кластера, когда это приложение возобновляет доступ к файлам на другом узле.
Синтаксис
typedef struct _NETWORK_APP_INSTANCE_ECP_CONTEXT {
USHORT Size;
USHORT Reserved;
GUID AppInstanceID;
} NETWORK_APP_INSTANCE_ECP_CONTEXT, *PNETWORK_APP_INSTANCE_ECP_CONTEXT;
Члены
Size
Размер этой структуры. Этот элемент имеет значение sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT).
Reserved
Скрытный. Должно быть задано равно нулю.
AppInstanceID
Уникальный идентификатор экземпляра для клиентского приложения отказоустойчивого кластера. Это GUID, который связывает приложение с файлом, открытым на узле отказоустойчивого кластера.
Замечания
При отработке отказа на дополнительный узел в кластере сервера клиентское приложение кластера должно возобновить доступ к файлам, которые он открылся на неработоспособный узел. Инфраструктура отработки отказа клиента кластера запрещает доступ к файлам приложения на узле отработки отказа, проверяя доступ к этим файлам. Доступ предоставляется файлам на узле отработки отказа с тем же идентификатором экземпляра приложения, что и файлы, открытые на другом узле до отработки отказа. Идентификатор экземпляра находится в NETWORK_APP_INSTANCE_ECP_CONTEXT структуре в списке ECP файла.
Например, драйвер фильтра файловой системы выделяет NETWORK_APP_INSTANCE_ECP_CONTEXT с уникальным GUID экземпляра приложения. Структура контекста вставляется в список ECP файла при его создании или открытии. Узлы кластера кэшируют идентификатор экземпляра из ECP при обработке запроса создания файловой системы сети. При отработки отказа узел возобновления может соответствовать приложению с набором открытых файлов и предоставлять доступ.
NETWORK_APP_INSTANCE_ECP_CONTEXT определяется в ECP_LISTGUID_ECP_NETWORK_APP_INSTANCE. Эти и другие системные идентификаторы описаны в System-DefinedECPs.
Сведения об использовании ECP для связывания дополнительных сведений с файлом при создании файла см. в разделе Использование дополнительных параметров создания с IRP_MJ_CREATE операцией.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Эта структура — Windows 8 |
| заголовка | ntifs.h (include Ntifs.h) |