Поделиться через

структура 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-Defined ECP.

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

Требования

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

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

ECP_LIST

IoCreateFileEx