WNetConnectionDialog 함수(winnetwk.h)

WNetConnectionDialog 함수는 네트워크 리소스에 연결하기 위한 일반 검색 대화 상자를 시작합니다. 함수에는 대화 상자의 소유자 창에 대한 핸들이 필요합니다.

구문

DWORD WNetConnectionDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

[in] hwnd

대화 상자의 소유자 창에 대한 핸들입니다.

[in] dwType

연결을 허용하는 리소스 유형입니다. 이 매개 변수는 다음 값일 수 있습니다.

값	의미
RESOURCETYPE_DISK	디스크 리소스에 대한 연결입니다.

함수가 성공하면 반환 값이 NO_ERROR. 사용자가 대화 상자를 취소하면 함수는 –1을 반환합니다.

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

반환 코드	설명
ERROR_EXTENDED_ERROR	네트워크 관련 오류가 발생했습니다. 오류에 대한 설명을 가져오려면 WNetGetLastError 함수를 호출합니다.
ERROR_INVALID_PASSWORD	지정한 암호가 잘못되었습니다.
ERROR_NO_NETWORK	네트워크를 사용할 수 없습니다.
ERROR_NOT_ENOUGH_MEMORY	대화 상자를 시작할 메모리가 부족합니다.

사용자가 대화 상자에서 확인을 클릭하면 WNetConnectionDialog 함수가 반환될 때 요청된 네트워크 연결이 만들어집니다.

함수가 연결을 시도하고 네트워크 공급자가 ERROR_INVALID_PASSWORD 메시지를 반환하는 경우 시스템에서 사용자에게 암호를 입력하라는 메시지를 표시합니다. 시스템은 연결을 위해 다른 시도에서 새 암호를 사용합니다.


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