Share via

InternetGetConnectedStateEx 함수(winineti.h)

  • 아티클
참고 이 API를 사용하지 않는 것이 좋습니다. 대신 INetworkListManager::GetConnectivity 메서드를 사용합니다.
 
지정된 인터넷 연결의 연결된 상태를 검색합니다.

구문

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [in]  DWORD   dwReserved
);

매개 변수

[out] lpdwFlags

연결 설명을 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 함수가 FALSE를 반환하는 경우에도 유효한 플래그를 반환할 수 있습니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

값 의미
INTERNET_CONNECTION_CONFIGURED
0x40
 로컬 시스템에는 인터넷에 대한 유효한 연결이 있지만 현재 연결되어 있거나 연결되지 않을 수 있습니다.
INTERNET_CONNECTION_LAN
0x02
 로컬 시스템은 로컬 영역 네트워크를 사용하여 인터넷에 연결합니다.
INTERNET_CONNECTION_MODEM
0x01
 로컬 시스템은 모뎀을 사용하여 인터넷에 연결합니다.
INTERNET_CONNECTION_MODEM_BUSY
0x08
 더 이상 사용되지 않습니다.
INTERNET_CONNECTION_OFFLINE
0x20
 로컬 시스템이 오프라인 모드입니다.
INTERNET_CONNECTION_PROXY
0x04
 로컬 시스템은 프록시 서버를 사용하여 인터넷에 연결합니다.

[out] lpszConnectionName

연결 이름을 수신하는 문자열 값에 대한 포인터입니다.

[in] dwNameLen

TCHAR에서 lpszConnectionName 문자열의 크기입니다.

[in] dwReserved

이 매개 변수는 예약되어 있으며 NULL이어야 합니다.

반환 값

인터넷 연결이 있는 경우 TRUE 를 반환하고, 인터넷 연결이 없거나 가능한 모든 인터넷 연결이 현재 활성화되지 않은 경우 FALSE 를 반환합니다. 자세한 내용은 주의 섹션을 참조하세요.

InternetGetConnectedState가 FALSE를 반환하면 애플리케이션에서 GetLastError를 호출하여 오류 코드를 검색할 수 있습니다.

설명

InternetGetConnectedState의 TRUE 반환 값은 인터넷에 대한 하나 이상의 연결을 사용할 수 있음을 나타냅니다. 특정 호스트에 대한 연결을 설정할 수 있다고 보장하지는 않습니다. 애플리케이션은 항상 서버에 연결하는 API 호출에서 반환되는 오류에 대해 검사 합니다. InternetCheckConnection 을 호출하여 특정 대상에 대한 연결을 설정할 수 있는지 확인할 수 있습니다.

TRUE의 반환 값은 모뎀 연결이 활성 상태이거나 LAN 연결이 활성 상태이고 프록시가 LAN에 대해 올바르게 구성되었음을 나타냅니다. FALSE의 반환 값은 모뎀과 LAN이 연결되지 않은 것을 나타냅니다. FALSE가 반환되면 자동 입력이 "항상 전화 걸기"로 구성되었지만 현재 활성 상태가 아님을 나타내도록 INTERNET_CONNECTION_CONFIGURED 플래그를 설정할 수 있습니다. autodial이 구성되지 않은 경우 함수는 FALSE를 반환합니다.

WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자에서 안전하게 호출할 수 없습니다.

참고 WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하지 않아야 합니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.
 

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winineti.h(Wininet.h, Winineti.h, Wininet.h, Winineti.h 포함)
라이브러리 Wininet.lib
DLL Wininet.dll

추가 정보

인터넷에 대한 전화 접속 연결 설정

WinINet 함수