루트 대상 서버가 오프라인인 경우에도 도메인 기반 DFS(분산 파일 시스템) 네임스페이스에서 지정된 루트 대상을 제거합니다. DFS 네임스페이스의 마지막 루트 대상이 제거되는 경우 함수는 DFS 네임스페이스도 삭제합니다. DFS 네임스페이스는 먼저 모든 링크를 삭제하지 않고 삭제할 수 있습니다.
참고NetDfsRemoveFtRootForced 함수는 DFS 루트 대상 서버의 레지스트리를 업데이트하지 않습니다. 자세한 내용은 설명 섹션을 참조하세요.
구문
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRootForced(
[in] LPWSTR DomainName,
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
DWORD Flags
);
매개 변수
[in] DomainName
제거할 도메인 기반 DFS 네임스페이스가 포함된 Active Directory 도메인의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 필수입니다.
[in] ServerName
제거할 DFS 루트 대상 서버의 이름을 지정하는 문자열에 대한 포인터입니다. 서버는 도메인 기반 DFS 네임스페이스의 루트를 호스트해야 합니다. 이 매개 변수는 필수입니다.
[in] RootShare
제거할 DFS 루트 대상 공유의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 필수입니다.
[in] FtDfsName
루트 대상을 제거할 도메인 기반 DFS 네임스페이스의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 필수입니다. 일반적으로 RootShare 매개 변수와 동일합니다.
Flags
0이어야 합니다.
반환 값
함수가 성공하면 반환 값이 NERR_Success.
함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.
설명
호출자는 디렉터리 서비스에서 DFS 컨테이너를 업데이트할 수 있는 권한이 있어야 하며 DFS 호스트(루트) 서버에 대한 관리자 권한이 있어야 합니다.
NetDfsRemoveFtRootForced 함수는 DFS 네임스페이스에서 도메인 기반 DFS 루트 대상을 강제로 제거합니다. 네임스페이스의 루트 대상 서버를 더 이상 사용할 수 없는 경우(예: 서비스 해제되었기 때문에) 도메인 기반 DFS 네임스페이스를 삭제하는 데 사용됩니다.
DFS 루트 대상 서버는 DFS 루트 대상 서버를 제거하지 않고 주 도메인 컨트롤러(PDC)에 연결하여 제거되므로 NetDfsRemoveFtRootForced 는 루트 대상 서버의 레지스트리를 업데이트하지 않습니다. 정상적인 상황에서 는 NetDfsRemoveFtRoot 함수를 호출하여 DFS 도메인 루트에서 루트 대상을 제거할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | lmdfs.h(LmDfs.h, Lm.h 포함) |
| 라이브러리 | Netapi32.lib |
| DLL | Netapi32.dll |