DFS_INFO_6 구조체(lmdfs.h)

아티클
08/24/2023

DFS(분산 파일 시스템) 루트 또는 링크에 대한 정보를 포함합니다. 이 구조체에는 이름, 상태, GUID, 제한 시간, 네임스페이스/루트/링크 속성, 메타데이터 크기, 대상 수 및 루트 또는 링크의 각 대상에 대한 정보가 포함됩니다. 이 구조체는 NetDfsEnum, NetDfsGetClientInfo 및 NetDfsGetInfo 함수에만 사용됩니다.

대상 정보 없이 DFS 네임스페이스에 대한 정보를 가져오려면 대신 DFS_INFO_5 사용합니다.

구문

typedef struct _DFS_INFO_6 {
  LPWSTR               EntryPath;
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  GUID                 Guid;
  ULONG                PropertyFlags;
  ULONG                MetadataSize;
  DWORD                NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO_1 Storage;
#else
  LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_6, *PDFS_INFO_6, *LPDFS_INFO_6;

멤버

EntryPath

DFS 루트 또는 링크의 UNC(범용 명명 규칙) 경로를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

링크의 경우 문자열은 두 가지 양식 중 하나일 수 있습니다. 첫 번째 양식은 다음과 같습니다.

\\Servername\DfsName\link_path

여기서 ServerName 은 독립 실행형 DFS 네임스페이스를 호스트하는 루트 대상 서버의 이름입니다. DfsName 은 DFS 네임스페이스의 이름입니다. link_path DFS 링크입니다.

두 번째 양식은 다음과 같습니다.

\\Domainname\DomDfsname\link_path

여기서 DomainName 은 도메인 기반 DFS 네임스페이스를 호스트하는 도메인의 이름입니다. DomDfsname 은 DFS 네임스페이스의 이름입니다. link_path DFS 링크입니다.

루트의 경우 문자열은 다음 두 가지 형식 중 하나일 수 있습니다.

\\Servername\DfsName

또는

\\Domainname\DomDfsname

여기서 이름의 값은 앞에서 설명한 값과 동일합니다.

Comment

DFS 루트 또는 링크와 연결된 주석이 포함된 null로 종료된 유니코드 문자열에 대한 포인터입니다.

State

DFS 루트 또는 링크를 설명하는 비트 플래그 집합을 지정합니다. 하나의 DFS_VOLUME_STATE 플래그가 설정되고 하나의 DFS_VOLUME_FLAVOR 플래그가 설정됩니다. DFS_VOLUME_FLAVORS 비트 마스크(0x00000300)를 사용하여 DFS 네임스페이스 버전을 추출해야 하며, 이 멤버에서 DFS 루트 또는 링크 상태를 추출하려면 DFS_VOLUME_STATES 비트 마스크(0x0000000F)를 사용해야 합니다. 플래그의 해석을 설명하는 예제는 DFS_INFO_2 설명 섹션을 참조하세요.

DFS_VOLUME_STATE_OK(0x00000001)

지정된 DFS 루트 또는 링크가 정상 상태입니다.

DFS_VOLUME_STATE_INCONSISTENT(0x00000002)

내부 DFS 데이터베이스가 지정된 DFS 루트 또는 링크와 일치하지 않습니다. 불일치 복구 시도가 실패했습니다.

DFS_VOLUME_STATE_OFFLINE(0x00000003)

지정된 DFS 루트 또는 링크가 오프라인이거나 사용할 수 없습니다.

DFS_VOLUME_STATE_ONLINE(0x00000004)

지정된 DFS 루트 또는 링크를 사용할 수 있습니다.

DFS_VOLUME_FLAVOR_STANDALONE(0x00000100)

루트가 독립 실행형 DFS 네임스페이스와 연결된 경우 시스템에서 이 플래그를 설정합니다.

DFS_VOLUME_FLAVOR_AD_BLOB(0x00000200)

루트가 도메인 기반 DFS 네임스페이스와 연결된 경우 시스템에서 이 플래그를 설정합니다.

Timeout

DFS 루트 또는 링크의 제한 시간(초)을 지정합니다.

Guid

DFS 루트 또는 링크의 GUID 를 지정합니다.

PropertyFlags

DFS 네임스페이스, 루트 또는 링크의 특정 속성을 설명하는 플래그 집합을 지정합니다.

DFS_PROPERTY_FLAG_INSITE_REFERRALS(0x00000001)

범위: 도메인 루트, 독립 실행형 루트 및 링크. 이 플래그는 DFS 루트에서 설정되면 모든 링크에 적용됩니다. 그렇지 않으면 각 개별 링크에 대해 이 플래그의 값이 고려됩니다.

이 플래그가 설정되면 DFS 루트에 대한 DFS 서버의 DFS 조회 응답 또는 "INSITE" 옵션이 활성화된 링크에는 조회를 요청하는 DFS 클라이언트와 동일한 사이트에 있는 대상만 포함됩니다. 두 전역 우선 순위 클래스의 대상은 사이트 위치에 관계없이 항상 반환됩니다.

DFS_PROPERTY_FLAG_ROOT_SCALABILITY(0x00000002)

범위: 도메인 기반 DFS 네임스페이스에 대한 전체 DFS 네임스페이스입니다.

기본적으로 DFS 루트 대상 서버는 PDS를 폴링하여 DFS 메타데이터에 대한 변경 내용을 검색합니다. PDC에서 서버 부하가 많이 발생하지 않도록 DFS 네임스페이스에 대해 루트 확장성을 사용하도록 설정할 수 있습니다. 이 플래그를 설정하면 DFS 서버가 공통 네임스페이스에 대한 DFS 메타데이터 변경에 대한 PDC 대신 가장 가까운 도메인 컨트롤러를 폴링합니다. 그러나 메타데이터에 대한 변경 내용은 PDC에서 계속 발생해야 합니다.

DFS_PROPERTY_FLAG_SITE_COSTING(0x00000004)

범위: 도메인 기반 및 독립 실행형 DFS 네임스페이스 모두에 대한 전체 DFS 네임스페이스입니다.

기본적으로 DFS 서버에서 DFS 클라이언트로 DFS 루트 또는 링크에 대한 조회 응답에서 반환되는 대상은 클라이언트와 동일한 사이트의 대상과 사이트 외부의 대상이라는 두 그룹으로 구성됩니다.

Active Directory에 대해 사이트 비용이 사용하도록 설정된 경우 응답에는 두 개 이상의 그룹이 있을 수 있으며, 각 그룹에는 조회를 요청하는 특정 DFS 클라이언트에 대해 동일한 사이트 비용이 포함된 대상이 포함될 수 있습니다. 그룹은 사이트 비용을 증가시켜 정렬됩니다. 사이트 비용을 사용하여 대상의 우선 순위를 지정하는 방법에 대한 자세한 내용은 DFS 서버 대상 우선 순위를 참조하세요.

DFS_PROPERTY_FLAG_TARGET_FAILBACK(0x00000008)

범위: 도메인 기반 DFS 루트, 독립 실행형 DFS 루트 및 DFS 링크. 이 플래그는 DFS 루트에서 설정되면 모든 링크에 적용됩니다. 그렇지 않으면 각 개별 링크에 대해 이 플래그의 값이 고려됩니다.

이 플래그가 설정되면 V4 DFS 클라이언트에 대해 최적의 대상 장애 복구를 사용하도록 설정되므로 최적이 아닌 클라이언트로 장애 조치(failover)한 후 최적의 대상으로 장애 복구(failback)할 수 있습니다. 대상 장애 복구 설정은 DFS 서버의 V4 조회 응답에서 DFS 클라이언트에 제공됩니다.

DFS_PROPERTY_FLAG_CLUSTER_ENABLED(0x00000010)

범위: 독립 실행형 DFS 루트 및 링크만.

DFS 루트는 스토리지 장애 조치(failover)에 대한 고가용성을 제공하기 위해 클러스터링됩니다. 이 플래그는 NetDfsSetInfo 함수를 사용하여 설정할 수 없습니다.

DFS_PROPERTY_FLAG_ABDE(0x00000020)

범위: 도메인 기반 DFS 루트 및 독립 실행형 DFS 루트입니다.

이 플래그가 설정되면 DFS 네임스페이스의 전체 DFS 루트 대상 공유에서 Access-Based 디렉터리 열거형(ABDE) 모드 지원을 사용하도록 설정됩니다. 이 플래그는 DFS_NAMESPACE_CAPABILITY_ABDE 기능 플래그가 설정된 DFS 네임스페이스에만 유효합니다. 자세한 내용은 DFS_INFO_50 및 DFS_SUPPORTED_NAMESPACE_VERSION_INFO 참조하세요.

DFS_PROPERTY_FLAG_ABDE 플래그는 루트 대상, 링크 또는 링크 대상이 아닌 DFS 네임스페이스 루트에서만 유효합니다. 보안 설명자를 DFS 링크와 연결하려면 이 플래그를 사용하도록 설정해야 합니다.

MetadataSize

도메인 기반 DFS 네임스페이스의 경우 이 멤버는 해당 Active Directory 데이터 Blob의 크기를 바이트 단위로 지정합니다. 독립 실행형 DFS 네임스페이스의 경우 이 필드는 키 이름 및 값 이름뿐만 아니라 연결된 특정 데이터 항목을 포함하여 레지스트리에 저장된 메타데이터의 크기를 지정합니다.

이 필드는 DFS 루트에만 유효합니다.

NumberOfStorages

DFS 루트 또는 링크의 대상 수를 지정합니다. 이러한 대상은 이 구조체의 Storage 멤버에 포함됩니다.

Storage

DFS 대상 정보를 포함하는 DFS_STORAGE_INFO_1 구조체의 배열을 지정합니다.

설명

서버 대상 우선 순위가 결정되는 방법에 대한 자세한 내용은 DFS 서버 대상 우선 순위를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008, Windows Server 2008
머리글	lmdfs.h(LmDfs.h, Lm.h 포함)