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_INSTANCE在 ECP_LIST 中标识 NETWORK_APP_INSTANCE_ECP_CONTEXT。 System-Defined ECP中介绍了此标识符和其他系统定义的标识符。
有关如何在创建文件时使用 ECP 将额外信息与文件相关联的信息,请参阅 将额外创建参数与IRP_MJ_CREATE操作。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 此结构是 Windows 8 |
标头 | ntifs.h (include Ntifs.h) |