DFS 네임스페이스에서 DFS(분산 파일 시스템) 링크 또는 DFS 링크의 특정 링크 대상을 제거합니다. 특정 링크 대상을 제거할 때 링크의 마지막 링크 대상이 제거되면 링크 자체가 제거됩니다.
구문
NET_API_STATUS NET_API_FUNCTION NetDfsRemove(
[in] LPWSTR DfsEntryPath,
[in, optional] LPWSTR ServerName,
[in, optional] LPWSTR ShareName
);
매개 변수
[in] DfsEntryPath
DFS 링크의 UNC(범용 명명 규칙) 경로를 지정하는 문자열에 대한 포인터입니다.
문자열은 두 가지 형식 중 하나일 수 있습니다. 첫 번째 양식은 다음과 같습니다.
\\ ShareName\DfsName\link_path
여기서 ShareName 은 독립 실행형 DFS 네임스페이스를 호스트하는 루트 대상 서버의 이름입니다. DfsName 은 DFS 네임스페이스의 이름입니다. 및 link_path DFS 링크입니다.
두 번째 양식은 다음과 같습니다.
\\ Domainname\DomDfsname\link_path
여기서 DomainName 은 도메인 기반 DFS 네임스페이스를 호스트하는 도메인의 이름입니다. DomDfsname 은 DFS 네임스페이스의 이름입니다. 및 link_path DFS 링크입니다.
이 매개 변수는 필수입니다.
[in, optional] ServerName
링크 대상의 서버 이름을 지정하는 문자열에 대한 포인터입니다. 자세한 내용은 아래 설명 부분을 참조하십시오. 링크와 모든 링크 대상을 제거하려면 이 매개 변수를 NULL 로 설정합니다.
[in, optional] ShareName
링크 대상의 공유 이름을 지정하는 문자열에 대한 포인터입니다. 링크와 모든 링크 대상을 제거하려면 이 매개 변수를 NULL 로 설정합니다.
반환 값
함수가 성공하면 반환 값이 NERR_Success.
함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.
설명
호출자는 DFS 서버에 대한 관리자 권한이 있어야 합니다. 관리자 권한이 필요한 함수를 호출하는 방법에 대한 자세한 내용은 특수 권한으로 실행을 참조하세요.
NetDfsRemove를 호출하여 링크에서 대상을 제거하는 경우 링크를 만들 때 지정한 ServerName 매개 변수에 동일한 대상 서버 이름을 지정해야 합니다. 예를 들어 대상을 링크에 추가할 때 대상 서버의 DNS 이름을 지정한 경우 링크를 제거할 때 동일한 DNS 이름을 지정해야 합니다. NetBIOS 이름을 지정할 수 없습니다.
예제
다음 코드 샘플에서는 NetDfsRemove 함수 호출을 사용하여 DFS 링크에서 대상을 제거하는 방법을 보여 줍니다.
#include <windows.h>
#include <lm.h>
#include <lmdfs.h>
#include <stdio.h>
#pragma comment(lib, "Netapi32.lib")
void wmain(int argc, wchar_t *argv[])
{
DWORD res;
//
// All parameters are required.
//
if (argc < 4)
wprintf(L"Syntax: %s DfsEntryPath ServerName ShareName\n", argv[0]);
else
{
//
// Call the NetDfsRemove function
// to remove the DFS link.
//
res = NetDfsRemove(argv[1], argv[2], argv[3]);
//
// Display the result of the call.
//
if(res == 0)
printf("Removed DFS link\n");
else
printf("Error: %u\n", res);
}
return;
}
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | lmdfs.h(LmDfs.h, Lm.h 포함) |
| 라이브러리 | Netapi32.lib |
| DLL | Netapi32.dll |