NETWORK_APP_INSTANCE_ECP_CONTEXT 구조체(ntifs.h)

  • 아티클

NETWORK_APP_INSTANCE_ECP_CONTEXT 구조는 ECP(추가 만들기 매개 변수)이며 파일과 연결할 애플리케이션 instance 식별자를 포함합니다. 이 구조는 해당 애플리케이션이 다른 노드의 파일에 대한 액세스를 다시 시작할 때 장애 조치(failover) 클러스터 클라이언트 애플리케이션에 대해 열린 파일을 식별하는 데 사용됩니다.

구문

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

예약되어 있습니다. 0으로 설정해야 합니다.

AppInstanceID

장애 조치(failover) 클러스터 클라이언트 애플리케이션에 대한 고유한 instance 식별자입니다. 장애 조치(failover) 클러스터 노드에서 열린 파일에 애플리케이션을 연결하는 GUID입니다.

설명

서버 클러스터의 보조 노드로 장애 조치(failover)가 발생하면 클러스터 클라이언트 애플리케이션이 실패한 노드에서 처음 연 파일에 대한 액세스를 다시 시작해야 합니다. 클러스터 클라이언트 장애 조치(failover) 인프라는 해당 파일에 대한 액세스의 유효성을 검사하여 장애 조치(failover) 노드의 애플리케이션 파일에 대한 공유 위반을 방지합니다. 장애 조치(failover) 전에 다른 노드에서 열린 파일과 동일한 애플리케이션 instance 식별자가 있는 장애 조치(failover) 노드의 파일에 대한 액세스 권한이 부여됩니다. instance 식별자는 파일의 ECP 목록의 NETWORK_APP_INSTANCE_ECP_CONTEXT 구조에서 찾을 수 있습니다.

예를 들어 파일 시스템 필터 드라이버는 고유한 애플리케이션 instance GUID를 사용하여 NETWORK_APP_INSTANCE_ECP_CONTEXT 할당합니다. 컨텍스트 구조는 파일을 만들거나 열 때 파일의 ECP 목록에 삽입됩니다. 클러스터 노드는 네트워크 파일 시스템 만들기 요청을 처리할 때 ECP에서 instance 식별자를 캐시합니다. 장애 조치(failover) 시 다시 시작 노드는 애플리케이션을 열린 파일 집합과 일치시키고 액세스 권한을 부여할 수 있습니다.

NETWORK_APP_INSTANCE_ECP_CONTEXT GUID_ECP_NETWORK_APP_INSTANCEECP_LIST 식별됩니다. 이 식별자 및 기타 시스템 정의 식별자는 시스템 정의 ECP에 설명되어 있습니다.

ECP를 사용하여 파일을 만들 때 추가 정보를 파일에 연결하는 방법에 대한 자세한 내용은 IRP_MJ_CREATE 작업과 함께 추가 만들기 매개 변수 사용을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 이 구조체는 Windows 8
머리글 ntifs.h(Ntifs.h 포함)

추가 정보

ECP_LIST

IoCreateFileEx