NPAddConnection3 함수(npapi.h)

NPAddConnection3 함수는 로컬 디바이스를 네트워크 리소스에 연결합니다. NPAddConnection과 동일한 작업을 수행하지만 결과 대화 상자를 소유해야 하는 창에 대한 핸들을 지정하고 연결을 설정하는 방법을 지정할 수 있습니다.

구문

DWORD NPAddConnection3(
  [in] HWND           hwndOwner,
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName,
  [in] DWORD          dwFlags
);

매개 변수

[in] hwndOwner

메시지 또는 대화 상자를 소유해야 하는 창에 대한 핸들입니다. 이 핸들은 dwFlags에서 CONNECT_INTERACTIVE 설정된 경우에만 유효하며, 핸들은 인증에 필요한 대화 상자를 생성하는 데만 사용해야 합니다.

[in] lpNetResource

연결할 네트워크 리소스를 지정하는 NETRESOURCE 구조체에 대한 포인터입니다. 연결할 때 다음 필드를 설정해야 합니다. 다른 소스는 무시됩니다.

[in] lpPassword

연결에 사용할 암호에 대한 포인터로, 일반적으로 lpUserName과 연결된 암호입니다. 함수가 기본 암호를 사용하도록 NULL 값을 전달할 수 있습니다. 빈 문자열을 사용하여 암호 없음을 나타낼 수 있습니다. 암호 사용을 마쳤으면 SecureZeroMemory 함수를 호출하여 메모리에서 암호를 지웁 수 있습니다. 암호 보호에 대한 자세한 내용은 암호 처리를 참조하세요.

[in] lpUserName

연결을 만드는 데 사용되는 사용자 이름에 대한 포인터입니다. NULL이면 기본 사용자 이름(현재 로그온한 사용자의 이름)이 적용됩니다. 사용자가 리소스에 연결하려고 하지만 해당 리소스에 대해 할당된 사용자 이름 또는 계정이 다른 경우에 사용됩니다.

[in] dwFlags

다음 값의 조합입니다. 공급자는 설정할 수 있는 다른 dwFlag 비트를 무시해야 합니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환합니다. 그렇지 않으면 오류 코드가 반환됩니다. 여기에는 다음 중 하나가 포함될 수 있습니다.

설명

지정된 자격 증명이 부족하고 CONNECT_INTERACTIVE 플래그가 설정되어 공급자가 암호 대화 상자를 표시하는 경우 공급자는 액세스 거부 오류 코드(ERROR_LOGON_FAILURE, WN_BAD_PASSWORD, WN_ACCESS_DENIED 중 하나)를 반환하지 않을 수 있습니다. 제안된 동작은 공급자가 사용자가 자격 증명을 제공하거나 "취소" 단추를 누를 때까지 사용자에게 유효한 자격 증명을 계속 요청하는 것입니다. WNetConnectionDialog 또는 WNetConnectionDialog1 함수 중에 요청된 연결을 만들기 위해 NPAddConnection3이 호출되고 액세스 거부 코드가 반환되면 WNetConnectionDialog 또는 WNetConnectionDialog1 함수 자체에 암호 대화 상자가 표시됩니다.

요구 사항

추가 정보

NPAddConnection