DFS_INFO_107 구조체(lmdfs.h)
주석, 상태, 제한 시간, 속성 플래그 및 링크 재분석 지점 보안 설명자를 포함하여 DFS 루트 또는 링크에 대한 정보를 포함합니다. 이 구조체는 NetDfsGetInfo 및 NetDfsSetInfo 함수에만 사용됩니다.
구문
typedef struct _DFS_INFO_107 {
LPWSTR Comment;
DWORD State;
ULONG Timeout;
ULONG PropertyFlagMask;
ULONG PropertyFlags;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
} DFS_INFO_107, *PDFS_INFO_107, *LPDFS_INFO_107;
멤버
Comment
DFS 루트 또는 링크와 연결된 주석이 포함된 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
State
DFS 루트 또는 링크를 설명하는 비트 플래그 집합을 지정합니다. 하나의 DFS_VOLUME_STATE 플래그가 설정되고 하나의 DFS_VOLUME_FLAVOR 플래그가 설정됩니다. DFS_VOLUME_FLAVORS 비트 마스크(0x00000300)를 사용하여 DFS 네임스페이스 버전을 추출해야 하며 DFS_VOLUME_STATES 비트 마스크(0x0000000F)를 사용하여 이 멤버에서 DFS 루트 또는 링크 상태를 추출해야 합니다. 플래그의 해석을 설명하는 예제는 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 루트 또는 링크의 제한 시간(초)을 지정합니다.
PropertyFlagMask
PropertyFlags 필드에서 평가에 유효한 플래그를 나타내는 마스크 값을 지정합니다.
PropertyFlags
Bitfield는 각 비트가 실제 속성에 따라 전체 DFS 네임스페이스, DFS 루트 또는 개별 DFS 링크에 적용되는 특정 속성을 담당합니다. 달리 표시되지 않는 한 모든 비트 조합이 허용됩니다.
DFS_PROPERTY_FLAG_INSITE_REFERRALS(0x00000001)
조회를 요청하는 클라이언트와 동일한 사이트에 있는 대상만 포함된 DFS 루트 또는 링크에 대한 DFS 서버의 조회 응답입니다. 두 전역 우선 순위 클래스의 대상은 사이트 위치에 관계없이 항상 반환됩니다. 이 플래그는 도메인 기반 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_PROPERTY_FLAG_CLUSTER_ENABLED(0x00000010)
이 플래그가 설정되면 DFS 루트가 클러스터링되어 스토리지 장애 조치(failover)에 대한 고가용성을 제공합니다. 이 플래그는 NetDfsSetInfo 함수를 사용하여 설정할 수 없으며 독립 실행형 DFS 루트 및 링크에만 적용됩니다.
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 링크와 연결하려면 이 플래그를 사용하도록 설정해야 합니다.
SecurityDescriptorLength
pSecurityDescriptor
DFS 링크의 재분석 지점과 연결할 자체 상대 보안 설명자를 지정하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 이 필드는 DFS 링크에만 유효합니다.
SdLengthReserved
이 멤버는 시스템 사용을 위해 예약되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista SP1 |
| 지원되는 최소 서버 | Windows Server 2008 |
| 머리글 | lmdfs.h(LmDfs.h, Lm.h 포함) |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기