NPGetConnection3 함수(npapi.h)

  • 아티클

현재 연결이 끊긴 경우에도 네트워크 연결에 대한 정보를 검색합니다.

구문

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

매개 변수

[in] lpLocalName

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

[in] dwLevel

네트워크 연결이 현재 연결되어 있는지 또는 연결이 끊어지는지 여부를 지정하는 값입니다.

값 의미
WNGETCON_CONNECTED
 네트워크 연결이 연결되었습니다.
WNGETCON_DISCONNECTED
 네트워크 연결이 끊어졌습니다.

[out] lpBuffer

요청된 정보가 포함된 버퍼를 수신하는 Void 포인터입니다.

[in, out] lpBufferSize

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

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 합니다.

함수가 실패하면 다음 값 중 하나를 반환해야 합니다.

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

설명

네트워크 연결은 연결됨, 연결 끊김 및 사용할 수 없는 세 가지 상태에 있을 수 있습니다. NPGetConnection3 함수는 현재 사용할 수 없는 네트워크 연결에 대한 정보를 검색할 수 없습니다. 그러나 Windows에서 연결 정보를 저장하기 때문에 현재 연결이 끊어진 네트워크 연결에 대한 정보를 검색할 수 있습니다.

요구 사항

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