WNetAddConnection3A 함수(winnetwk.h)

WNetAddConnection3 함수는 네트워크 리소스에 연결합니다. 이 함수는 로컬 디바이스를 네트워크 리소스로 리디렉션할 수 있습니다.

WNetAddConnection3 함수는 WNetAddConnection2 함수와 비슷합니다. 주요 차이점은 WNetAddConnection3 추가 매개 변수, 네트워크 리소스 공급자가 대화 상자의 소유자 창으로 사용할 수 있는 창에 대한 핸들이 있다는 것입니다. WNetAddConnection2 함수와 WNetAddConnection3 함수는 WNetAddConnection 함수를 대체합니다.

통사론

DWORD WNetAddConnection3A(
  [in] HWND           hwndOwner,
  [in] LPNETRESOURCEA lpNetResource,
  [in] LPCSTR         lpPassword,
  [in] LPCSTR         lpUserName,
  [in] DWORD          dwFlags
);

매개 변수

[in] hwndOwner

네트워크 리소스 공급자가 대화 상자의 소유자 창으로 사용할 수 있는 창에 대한 핸들입니다. dwFlags 매개 변수에서 CONNECT_INTERACTIVE 값을 설정하는 경우 이 매개 변수를 사용합니다.

hwndOwner 매개 변수는 NULL수 있습니다. 이 경우 WNetAddConnection3 호출은 WNetAddConnection2 함수를 호출하는 것과 같습니다.

[in] lpNetResource

네트워크 리소스, 로컬 디바이스 및 네트워크 리소스 공급자에 대한 정보와 같이 제안된 연결의 세부 정보를 지정하는 NETRESOURCE 구조체에 대한 포인터입니다.

NETRESOURCE 구조체의 다음 멤버를 지정해야 합니다.

WNetAddConnection3 함수는 NETRESOURCE 구조체의 다른 멤버를 무시합니다.

[in] lpPassword

네트워크 연결을 만드는 데 사용할 암호를 지정하는 null종료된 문자열에 대한 포인터입니다.

lpPassword NULL경우 함수는 lpUserName 매개 변수로 지정된 사용자와 연결된 현재 기본 암호를 사용합니다.

lpPassword 빈 문자열을 가리키는 경우 함수는 암호를 사용하지 않습니다.

잘못된 암호로 인해 연결이 실패하고 CONNECT_INTERACTIVE 값이 dwFlags 매개 변수에 설정된 경우 함수는 사용자에게 암호를 입력하도록 요청하는 대화 상자를 표시합니다.

Windows Me/98/95: 이 매개 변수는 NULL 또는 빈 문자열을 합니다.

[in] lpUserName

연결을 만들기 위한 사용자 이름을 지정하는 null종료된 문자열에 대한 포인터입니다.

lpUserName NULL경우 함수는 기본 사용자 이름을 사용합니다. (프로세스의 사용자 컨텍스트는 기본 사용자 이름을 제공합니다.)

lpUserName 매개 변수는 사용자가 기본 사용자 이름 또는 계정 이외의 사용자 이름 또는 계정이 할당된 네트워크 리소스에 연결하려는 경우에 지정됩니다.

사용자 이름 문자열은 보안 컨텍스트나타냅니다. 네트워크 공급자에 한정될 수 있습니다.

Windows Me/98/95: 이 매개 변수는 NULL 또는 빈 문자열을 합니다.

[in] dwFlags

연결 옵션 집합입니다. 현재 정의된 값은 다음과 같습니다.

반환 값

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

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

발언

WNetUseConnection 함수는 WNetAddConnection3 함수와 비슷합니다. 주요 차이점은 WNetUseConnection 사용하지 않는 로컬 디바이스를 자동으로 선택하여 네트워크 리소스로 리디렉션할 수 있다는 것입니다.

Windows Server 2003 및 Windows XP에서 WNet 함수는 MS-DOS 디바이스가 AuthenticationID(a)로 식별되기 때문에 로그온 세션과 연결된 MS-DOS 디바이스 네임스페이스에서 네트워크 드라이브 문자를 만들고 삭제합니다.
로그온 세션과 연결된 로컬 고유 식별자또는 LUID를 . 이는 WNet 함수 중 하나를 호출하여 한 사용자 로그온 아래에 네트워크 드라이브 문자를 만드는 애플리케이션에 영향을 줄 수 있지만 다른 사용자 로그온에서 기존 네트워크 드라이브 문자를 쿼리합니다. 예를 들어 CreateProcessAsUser 함수를 호출하여 사용자의 두 번째 로그온이 로그온 세션 내에 만들어지고 두 번째 로그온이 GetLogicalDrives 함수를 호출하는 애플리케이션을 실행하는 경우를 예로 들어 보겠습니다. GetLogicalDrives 함수에 대한 호출은 첫 번째 로그온에서 WNet 함수 호출에 의해 생성된 네트워크 드라이브 문자를 반환하지 않습니다. 앞의 예제에서는 첫 번째 로그온 세션이 여전히 존재하며 이 예제는 터미널 서비스 세션을 비롯한 모든 로그온 세션에 적용할 수 있습니다. 자세한 내용은 MS-DOS 디바이스 이름정의를 참조하세요.

Windows Server 2003 및 Windows XP에서 LocalSystem으로 실행되는 서비스가 WNetAddConnection3 함수를 호출하는 경우 매핑된 드라이브가 모든 사용자 로그온 세션에 표시됩니다.

Microsoft 네트워크 공급자의 경우 lpNetResource 매개 변수가 가리키는 NETRESOURCE 구조의 lpRemoteName 멤버는 점선 소수점 표기법으로 IPv4 주소를 포함할 수 있습니다. 공유의 예는 다음과 같습니다.

\192.168.1.1\share

Windows Vista 이상의 Microsoft 네트워크 공급자의 경우 lpNetResource 매개 변수가 가리키는 NETRESOURCE 구조의 lpRemoteName 멤버는 IPv6 주소를 포함할 수 있습니다. 그러나 IPv6 주소가 올바르게 구문 분석되도록 IPv6 리터럴 형식을 사용해야 합니다. IPv6 리터럴 주소는 다음과 같은 형식입니다.

':' 문자가 있는 ipv6-address는 '-' 문자와 ".ipv6-literal.net" 문자열로 바뀝니다.

예를 들어 다음 IPv6 주소는 다음과 같습니다.

2001:4898:9:3:c069:aa97:fe76:2449

공유의 예는 다음과 같습니다.

\2001-4898-9-3-c069-aa97-fe76-2449.ipv6-literal.net\share

다른 네트워크 공급자는 IPv4 또는 IPv6 주소를 포함하는 lpNetResource 매개 변수가 가리키는 NETRESOURCE 구조의 lpRemoteName 멤버를 지원할 수 있지만 이는 특정 네트워크 공급자에게 달려 있습니다.

Windows 7 및 Windows Server 2008 R2: WNetAddConnection3 함수가 pUsername 지정된 명시적 사용자 자격 증명으로 호출되는 경우 lpPassword 특정 서버에서 네트워크 리소스와의 연결을 설정한 다음 이러한 매개 변수 중 하나를 사용하여 동일한 서버에 NULL(기본 사용자 이름 또는 기본 암호 사용)로 다시 호출합니다. 오류가 있는 호출입니다. 반환되는 오류는 ERROR_BAD_USERNAME 또는 ERROR_INVALID_PASSWORD.

요구 사항

참고 항목

NETRESOURCE

WNetAddConnection2

WNetCancelConnection2

WNetGetConnection

WNetUseConnection

WNet(Windows 네트워킹) 개요

windows 네트워킹 함수