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