DFS_INFO_2 구조체(lmdfs.h)

아티클
03/14/2023

DFS(분산 파일 시스템) 루트 또는 링크에 대한 정보를 포함합니다. 이 구조체에는 루트 또는 링크의 이름, 상태 및 DFS 대상 수가 포함됩니다. 이 구조체는 NetDfsEnum, NetDfsGetClientInfo 및 NetDfsGetInfo 함수 및 FSCTL_DFS_GET_PKT_ENTRY_STATE 제어 코드에만 사용됩니다.

구문

typedef struct _DFS_INFO_2 {
  LPWSTR EntryPath;
  LPWSTR Comment;
  DWORD  State;
  DWORD  NumberOfStorages;
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2;

멤버

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_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 네임스페이스와 연결된 경우 시스템에서 이 플래그를 설정합니다.

NumberOfStorages

DFS 대상 수를 지정합니다.

설명

DFS 함수는 DFS_INFO_2 구조를 사용하여 DFS 루트 또는 링크에 대한 정보를 검색합니다.

다음은 상태 멤버에서 반환할 수 있는 플래그의 해석을 설명하는 예제입니다.

FlavorBits = (Flags &amp; DFS_VOLUME_FLAVORS)
If (FlavorBits == DFS_VOLUME_FLAVOR_STANDALONE)   // namespace is stand-alone DFS
else if (FlavorBits == DFS_VOLUME_FLAVOR_AD_BLOB) // namespace is AD blob
else                                              // unknown flavor

StateBits = (Flags &amp; DFS_VOLUME_STATES)
// StateBits can be one of the following: 
//  (DFS_VOLUME_STATE_OK, DFS_VOLUME_STATE_INCONSISTENT, 
//   DFS_VOLUME_STATE_OFFLINE or DFS_VOLUME_STATE_ONLINE)