estructura de NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

La estructura de 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

Un 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 a un archivo abierto en un nodo de clúster de conmutación por error.

Comentarios

Cuando se produce la conmutación por error a un nodo secundario en un clúster de servidores, 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 del cliente de clúster evita infracciones de uso compartido de los archivos de la aplicación en el nodo de conmutación por error validando 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_LIST por GUID_ECP_NETWORK_APP_INSTANCE. Este y otros identificadores definidos por el sistema se describen en ECP definidos por el sistema.

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

Consulte también

ECP_LIST

IoCreateFileEx