NetUseDel 함수(lmuse.h)

  • 아티클

NetUseDel 함수는 공유 리소스에 대한 연결을 종료합니다.

WNetCancelConnection2 함수를 사용하여 네트워크 연결을 종료할 수도 있습니다.

구문

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

매개 변수

[in] UncServerName

이 함수를 실행할 컴퓨터의 UNC 이름입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

지정된 UncServerName 매개 변수가 원격 컴퓨터인 경우 원격 컴퓨터는 레거시 원격 액세스 프로토콜 메커니즘을 사용하여 원격 RPC 호출을 지원해야 합니다.

_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.

[in] UseName

삭제할 연결 경로를 지정하는 문자열에 대한 포인터입니다.

_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.

[in] ForceLevelFlags

연결을 삭제하는 데 사용할 힘 수준입니다.

이 매개 변수는 lmuseflg.h 헤더 파일에 정의된 다음 값 중 하나일 수 있습니다.

값 의미
USE_NOFORCE
 열려 있는 파일이 연결에 있는 경우 연결 끊김에 실패합니다.
USE_FORCE
 열려 있는 파일이 연결에 있는 경우 연결 끊김에 실패하지 마세요.
USE_LOTS_OF_FORCE
 열려 있는 파일을 닫고 연결을 삭제합니다.

반환 값

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

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

설명

NetUseDel 함수는 서버 메시지 블록(LAN 관리자 워크스테이션) 클라이언트에만 적용됩니다. NetUseDel 함수는 DFS(분산 파일 시스템) 공유 또는 기타 네트워크 파일 시스템을 지원하지 않습니다. 다른 네트워크 공급자(예: WebDAV 또는 DFS 공유)를 사용하여 공유에 대한 연결을 종료하려면 WNetCancelConnection2 함수를 사용합니다.

NetUseDel 함수를 호출하는 데 특별한 그룹 멤버 자격은 필요하지 않습니다. 이 함수는 하위 호환성의 경우를 제외하고 원격 서버에서 실행할 수 없습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 lmuse.h(Lm.h 포함)
라이브러리 Netapi32.lib
DLL Netapi32.dll

참고 항목

NetUseAdd

네트워크 관리 함수

네트워크 관리 개요

함수 사용

WNetCancelConnection2