NPAddConnection 함수(npapi.h)

  • 아티클

NPAddConnection 함수는 로컬 디바이스를 네트워크 리소스에 연결합니다.

구문

DWORD NPAddConnection(
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName
);

매개 변수

[in] lpNetResource

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

값 의미
lpRemoteName
 연결할 네트워크 리소스를 지정합니다.
lpLocalName
 리디렉션할 로컬 디바이스의 이름(예: "F:" 또는 "LPT1")을 지정합니다. 이 이름은 대/소문자를 구분하지 않는 것으로 처리되며 빈 문자열 또는 NULL 포인터일 수 있습니다. 문자열이 비어 있거나 NULL인 경우 함수는 리디렉션을 하지 않고 네트워크 리소스에 연결합니다.
dwType
 연결할 리소스의 유형을 지정합니다. RESOURCETYPE_DISK, RESOURCETYPE _PRINT 또는 RESOURCETYPE_ANY 수 있습니다. 호출자가 신경 쓰지 않거나 모르는 경우 RESOURCETYPE _ANY 값이 사용됩니다.

[in] lpPassword

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

[in] lpUserName

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

예를 들어 사용자 이름 "MyAccount"를 사용하여 로깅하고 사용자 이름이 "MyOtherAccount"인 두 번째 계정에만 사용할 수 있는 네트워크 리소스에 연결하려는 경우 리소스에 연결하기 위해 lpUserName 에서 "MyOtherAccount"를 지정할 수 있습니다. 또한 lpPassword에서 이 두 번째 계정의 암호를 지정합니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 합니다. 그렇지 않으면 다음 중 하나일 수 있는 오류 코드를 반환해야 합니다.

반환 코드 설명
WN_BAD_NETNAME
 lpNetResource에 전달된 구조체의 lpRemoteName 멤버 값이 이 공급자에 대해 유효하지 않습니다.
WN_BAD_LOCALNAME
 lpNetResource에 전달된 구조체의 lpLocalName 멤버 값이 잘못되었습니다.
WN_BAD_PASSWORD
 지정한 암호가 잘못되었습니다.
WN_ALREADY_CONNECTED
 lpNetResource에 전달된 구조체의 lpLocalName 멤버에 지정된 디바이스가 이미 연결되어 있습니다.
WN_ACCESS_DENIED
 연결을 설정할 수 있는 권한이 거부되었습니다.
WN_NO_NETWORK
 네트워크가 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 npapi.h