NetDfsGetClientInfo 함수(lmdfs.h)

아티클
03/14/2023

DFS 클라이언트에서 유지 관리하는 캐시에서 DFS(분산 파일 시스템) 루트 또는 링크에 대한 정보를 검색합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [out]          LPBYTE *Buffer
);

매개 변수

[in] DfsEntryPath

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

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

\\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

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

이 매개 변수는 필수입니다.

[in, optional] ServerName

DFS 루트 대상 또는 링크 대상 서버의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] ShareName

DFS 루트 대상 또는 링크 대상에 해당하는 공유의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in] Level

요청의 정보 수준을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

1

DFS 루트 또는 DFS 링크 이름을 반환합니다. Buffer 매개 변수는 DFS_INFO_1 구조를 가리킵니다.

2

DFS 루트 또는 DFS 링크 이름, 상태 및 DFS 대상 수를 반환합니다. Buffer 매개 변수는 DFS_INFO_2 구조를 가리킵니다.

3

DFS 루트 또는 DFS 링크 이름, 상태 및 대상 정보를 반환합니다. Buffer 매개 변수는 DFS_INFO_3 구조를 가리킵니다.

4

DFS 루트 또는 DFS 링크 이름, 상태, GUID, 제한 시간 및 대상 정보를 반환합니다. Buffer 매개 변수는 DFS_INFO_4 구조를 가리킵니다.

[out] Buffer

요청된 정보를 수신하는 버퍼의 주소에 대한 포인터입니다. 이 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수를 사용하여 해제해야 합니다. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크 관리 함수 버퍼 길이를 참조하세요.

반환 값

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.

설명

NetDfsGetClientInfo 함수를 사용하기 위해 특별한 그룹 멤버 자격이 필요하지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	lmdfs.h(LmDfs.h, Lm.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll