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,用于将应用程序关联到故障转移群集节点上打开的文件。

注解

当故障转移到服务器群集中的辅助节点时,群集客户端应用程序需要恢复对它第一次在故障节点上打开的文件的访问权限。 群集客户端故障转移基础结构通过验证应用程序对这些文件的访问权限,防止在故障转移节点上共享应用程序文件冲突。 授予对故障转移节点上的文件的访问权限,其应用程序实例标识符与故障转移之前在其他节点上打开的文件具有相同的应用程序实例标识符。 实例标识符位于文件的 ECP 列表中的 NETWORK_APP_INSTANCE_ECP_CONTEXT 结构中。

例如,文件系统筛选器驱动程序将分配具有唯一应用程序实例 GUID 的NETWORK_APP_INSTANCE_ECP_CONTEXT 。 上下文结构在创建或打开文件时插入到文件的 ECP 列表中。 处理网络文件系统创建请求时,群集节点会缓存 ECP 中的实例标识符。 故障转移时,恢复节点可以将应用程序与其打开的文件集匹配,并授予访问权限。

GUID_ECP_NETWORK_APP_INSTANCEECP_LIST中标识NETWORK_APP_INSTANCE_ECP_CONTEXT。 系统定义的 ECP 中介绍了此标识符和其他 系统定义的标识符。

有关如何在创建文件时使用 ECP 将额外信息与文件关联的信息,请参阅 将额外创建参数与IRP_MJ_CREATE操作配合使用

要求

要求
最低受支持的客户端 此结构Windows 8
标头 ntifs.h (包括 Ntifs.h)

另请参阅

ECP_LIST

IoCreateFileEx