다음을 통해 공유

WNetRestoreConnectionW 함수(winnetwk.h)

  • 아티클

[WNetRestoreConnectionW 는 Windows Vista를 기준으로 사용할 수 없습니다.]

WNetRestoreConnectionW 함수는 네트워크 리소스에 대한 연결을 복원합니다. 함수는 필요한 경우 사용자에게 이름과 암호를 묻는 메시지를 표시합니다.

구문

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

매개 변수

[in] hWnd

네트워크 연결을 만들 때 사용자에게 이름과 암호를 묻는 메시지를 표시하는 UI(사용자 인터페이스)를 표시하기 위해 함수가 사용하는 부모 창에 대한 핸들입니다. 이 매개 변수가 NULL이면 소유자 창이 없습니다.

[in] lpDevice

연결할 드라이브의 로컬 이름(예: "Z:")을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 함수는 현재 사용자의 레지스트리에 저장된 모든 영구 드라이브를 다시 연결합니다.

반환 값

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

함수가 실패하면 반환 값은 다음 값 중 하나와 같은 시스템 오류 코드입니다.

반환 코드 설명
ERROR_ACCESS_DENIED
 호출자에게 네트워크 리소스에 대한 액세스 권한이 없습니다.
ERROR_ALREADY_ASSIGNED
 lpDevice로 지정된 로컬 디바이스가 이미 네트워크 리소스에 연결되어 있습니다.
ERROR_BAD_DEV_TYPE
 로컬 디바이스의 유형 및 네트워크 리소스 유형이 일치하지 않습니다.
ERROR_BAD_DEVICE
 lpDevice에 지정된 값이 잘못되었습니다.
ERROR_BAD_PROFILE
 사용자 프로필 형식이 잘못되었습니다.
ERROR_BUSY
 라우터 또는 공급자가 초기화 중일 수 있습니다. 호출자는 다시 시도해야 합니다.
ERROR_CANCELLED
 네트워크 리소스 공급자 중 하나 또는 호출된 리소스의 대화 상자를 통해 사용자가 연결을 시도하지 못했습니다.
ERROR_CANNOT_OPEN_PROFILE
 시스템에서 영구 연결을 처리하기 위해 사용자 프로필을 열 수 없습니다.
ERROR_DEVICE_ALREADY_REMEMBERED
 디바이스에 대한 항목이 이미 사용자 프로필에 있습니다.
ERROR_EXTENDED_ERROR
 네트워크 관련 오류가 발생했습니다. WNetGetLastError 함수를 호출하여 오류에 대한 설명을 가져옵니다.
ERROR_INVALID_PASSWORD
 지정한 암호가 잘못되었습니다.
ERROR_NO_NET_OR_BAD_PATH
 네트워크 구성 요소가 시작되지 않았거나 지정된 이름을 사용할 수 없으므로 작업을 수행할 수 없습니다.
ERROR_NO_NETWORK
 네트워크를 사용할 수 없습니다.

설명

WNetRestoreConnectionW 함수는 Windows Vista 이상에서 지원되지 않습니다.

이 함수를 호출하려면 먼저 LoadLibrary 함수를 호출하여 Mpr.dll 로드합니다. 그런 다음 GetProcAddress 함수를 호출하여 WNetRestoreConnectionW 함수의 주소를 검색합니다.

WNetRestoreConnectionW 는 Winlogon에서 대화형 로그온 프로세스 중에 모든 영구 드라이브 매핑을 복원하는 데 사용됩니다. 함수는 사용자의 요청에 따라 개별 드라이브를 다시 연결하기 위해 Microsoft Windows Shell에서도 호출됩니다. 예를 들어 로그온 시 드라이브가 다시 연결되지 못하고 사용자가 내 컴퓨터 가상 폴더 아래의 드라이브를 두 번 클릭하는 경우 이 문제가 발생할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winnetwk.h
라이브러리 Mpr.lib
DLL Mpr.dll

추가 정보

WNet(Windows 네트워킹) 개요

Windows 네트워킹 함수