NPGetConnection 함수(npapi.h)

연결에 대한 정보를 검색합니다.

구문

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

[in] lpLocalName

호출자가 관심 있는 로컬 디바이스의 이름에 대한 포인터입니다. 네트워크 공급자는 이 이름이 구문상 유효하다고 가정할 수 있습니다.

[out] lpRemoteName

연결을 만드는 데 사용되는 원격 이름을 수신하는 버퍼에 대한 포인터입니다. 이 버퍼는 호출자가 할당합니다.

[in, out] lpnBufferLen

lpRemoteName 버퍼의 크기(문자)에 대한 포인터입니다. 버퍼가 충분히 크지 않아 호출이 실패하면 lpBufferSize 가 필요한 버퍼 크기로 설정됩니다.

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

반환 코드	설명
WN_NOT_CONNECTED	lpLocalName으로 지정된 디바이스는 이 공급자에 의해 리디렉션되지 않습니다.
WN_MORE_DATA	버퍼가 너무 작아서 모든 데이터를 수신할 수 없습니다.
WN_NO_NETWORK	네트워크가 없습니다.

NPGetConnection 함수는 현재 연결된 네트워크 연결에 대한 정보만 반환할 수 있습니다. 현재 연결이 끊긴 네트워크 연결에 대한 정보를 검색하려면 NPGetConnection3을 사용합니다.