DFS_INFO_105 구조체(lmdfs.h)

아티클
08/24/2023

속성 플래그로 지정된 주석, 상태, 제한 시간 및 DFS 동작을 포함하여 DFS 루트 또는 링크에 대한 정보를 포함합니다. 이 구조체는 NetDfsSetInfo 함수에만 사용됩니다.

구문

typedef struct _DFS_INFO_105 {
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  ULONG  PropertyFlagMask;
  ULONG  PropertyFlags;
} DFS_INFO_105, *PDFS_INFO_105, *LPDFS_INFO_105;

멤버

Comment

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

State

DFS 루트 또는 링크의 상태를 설명하는 비트 플래그 집합을 지정합니다. DFS 네임스페이스 루트의 상태를 변경할 수 없습니다. 하나의 DFS_VOLUME_STATE 플래그가 설정되고 하나의 DFS_VOLUME_FLAVOR 플래그가 설정됩니다. 이러한 플래그의 해석을 설명하는 예제는 DFS_INFO_2 설명 섹션을 참조하세요.

기본값(0x00000000)

기존 상태를 유지합니다.

DFS_VOLUME_STATE_OK(0x00000001)

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

DFS_VOLUME_STATE_OFFLINE(0x00000003)

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

DFS_VOLUME_STATE_ONLINE(0x00000004)

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

Timeout

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

PropertyFlagMask

PropertyFlags 필드에서 평가에 유효한 플래그를 나타내는 마스크 값을 지정합니다.

PropertyFlags

Bitfield는 각 비트가 실제 속성에 따라 전체 DFS 네임스페이스, DFS 루트 또는 개별 DFS 링크에 적용되는 특정 속성을 담당합니다. 달리 표시되지 않는 한 모든 비트 조합이 허용됩니다.

DFS_PROPERTY_FLAG_INSITE_REFERRALS(0x00000001)

조회를 요청하는 클라이언트와 동일한 사이트에 있는 대상만 포함된 DFS 루트 또는 링크에 대한 DFS 서버의 조회 응답입니다. 두 전역 우선 순위 클래스의 대상은 사이트 위치와 관계없이 항상 반환됩니다. 이 플래그는 도메인 기반 DFS 루트, 독립 실행형 루트 및 링크에 적용됩니다. 이 플래그가 DFS 루트에 설정된 경우 모든 링크에 적용됩니다. 그렇지 않으면 개별 링크에 적용됩니다. 링크에서 를 설정해도 루트 설정은 재정의되지 않습니다.

DFS_PROPERTY_FLAG_ROOT_SCALABILITY(0x00000002)

이 플래그가 설정된 경우 DFS 서버는 PDC(주 도메인 컨트롤러) 대신 가장 가까운 DC(도메인 컨트롤러)를 폴링하여 해당 네임스페이스에 대한 DFS 네임스페이스 변경 내용을 검사. DFS 서버에서 DFS 메타데이터를 수정하는 작업은 이 플래그에 의해 제어되지 않지만 PDC로 자동으로 전송됩니다. 이 플래그는 전체 네임스페이스에 적용되며 도메인 기반 DFS 네임스페이스에만 유효합니다.

DFS_PROPERTY_FLAG_SITE_COSTING(0x00000004)

대상의 Active Directory 사이트 비용 계산을 사용하도록 설정하려면 이 플래그를 설정합니다. DFS 서버에서 요청 DFS 클라이언트로 반환되는 대상은 DFS 클라이언트와 관련하여 사이트 간 비용으로 그룹화됩니다. 그룹은 클라이언트와 동일한 사이트의 대상으로 구성된 첫 번째 그룹으로 사이트 비용을 증가시키는 측면에서 정렬됩니다. 각 그룹 내의 대상은 임의로 정렬됩니다.

이 플래그를 사용하도록 설정하지 않으면 기본 반환은 클라이언트와 동일한 사이트에 있는 대상 집합 하나와 나머지 모든 대상 집합의 두 집합입니다. 이 플래그는 전체 DFS 네임스페이스에 적용되며 도메인 기반 및 독립 실행형 DFS 네임스페이스 모두에 유효합니다.

대상 우선 순위는 대상 순서에 더 많은 영향을 줄 수 있습니다. 사이트 비용을 사용하여 대상의 우선 순위를 지정하는 방법에 대한 자세한 내용은 DFS 서버 대상 우선 순위를 참조하세요.

DFS_PROPERTY_FLAG_TARGET_FAILBACK(0x00000008)

V4 DFS 클라이언트가 더 최적의(낮은 비용 또는 더 높은 우선 순위) 대상으로 장애 복구(failback)할 수 있도록 하려면 이 플래그를 설정합니다. 이 플래그가 DFS 루트에 설정된 경우 모든 링크에 적용됩니다. 그렇지 않으면 개별 링크에 적용됩니다. 개별 링크 설정은 루트 설정을 재정의하지 않습니다. 대상 장애 복구 설정은 DFS 서버의 V4 조회 응답에서 DFS 클라이언트에 제공됩니다. 이 플래그는 도메인 기반 DFS 루트, 독립 실행형 루트 및 링크에 적용됩니다.

DFS_PROPERTY_FLAG_CLUSTER_ENABLED(0x00000010)

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

이 플래그가 설정되면 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 링크와 연결하려면 이 플래그를 사용하도록 설정해야 합니다.

요구 사항


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