estructura NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)
La estructura NETWORK_APP_INSTANCE_ECP_CONTEXT es un parámetro de creación adicional (ECP) y contiene un identificador de instancia de aplicación que se va a asociar a un archivo. Esta estructura se usa para identificar los archivos abiertos para una aplicación cliente de clúster de conmutación por error cuando esa aplicación reanuda el acceso a sus archivos en otro nodo.
Sintaxis
typedef struct _NETWORK_APP_INSTANCE_ECP_CONTEXT {
USHORT Size;
USHORT Reserved;
GUID AppInstanceID;
} NETWORK_APP_INSTANCE_ECP_CONTEXT, *PNETWORK_APP_INSTANCE_ECP_CONTEXT;
Miembros
Size
Tamaño de esta estructura. Este miembro se establece en sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT).
Reserved
Reservado. Debe establecerse en cero.
AppInstanceID
Identificador de instancia único para una aplicación cliente de clúster de conmutación por error. Se trata de un GUID que asocia una aplicación al archivo abierto en un nodo de clúster de conmutación por error.
Observaciones
Cuando se produce la conmutación por error a un nodo secundario en un clúster de servidor, una aplicación cliente de clúster necesita reanudar el acceso a los archivos que abrió por primera vez en el nodo con errores. La infraestructura de conmutación por error de cliente de clúster impide el uso compartido de infracciones de los archivos de la aplicación en el nodo de conmutación por error mediante la validación de su acceso a esos archivos. Se concede acceso a los archivos en el nodo de conmutación por error que tienen el mismo identificador de instancia de aplicación que los archivos abiertos en otro nodo tenían antes de la conmutación por error. El identificador de instancia se encuentra en una estructura de NETWORK_APP_INSTANCE_ECP_CONTEXT en la lista ECP de un archivo.
Por ejemplo, un controlador de filtro del sistema de archivos asignará un NETWORK_APP_INSTANCE_ECP_CONTEXT con el GUID de instancia de aplicación único. La estructura de contexto se inserta en la lista ECP de un archivo cuando se crea o abre. Los nodos del clúster almacenan en caché el identificador de instancia del ECP al procesar la solicitud de creación del sistema de archivos de red. En la conmutación por error, el nodo de reanudación puede coincidir con la aplicación con su conjunto de archivos abiertos y conceder acceso.
El NETWORK_APP_INSTANCE_ECP_CONTEXT se identifica en un ECP_LISTGUID_ECP_NETWORK_APP_INSTANCE. Este y otros identificadores definidos por el sistema se describen en System-Defined ECP.
Para obtener información sobre cómo usar ECP para asociar información adicional a un archivo cuando se crea el archivo, vea Using Extra Create Parameters with an IRP_MJ_CREATE Operation.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Esta estructura es Windows 8 |
| encabezado de |
ntifs.h (incluya Ntifs.h) |