IsNetworkAlive 함수(sensapi.h)
IsNetworkAlive 함수는 로컬 시스템이 네트워크에 연결되어 있는지 여부를 결정하고 LAN, WAN 또는 둘 다와 같은 네트워크 연결 유형을 식별합니다.
구문
BOOL IsNetworkAlive(
[out] LPDWORD lpdwFlags
);
매개 변수
[out] lpdwFlags
사용할 수 있는 네트워크 연결 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
NETWORK_ALIVE_LAN
컴퓨터에 활성 상태인 LAN 카드가 하나 이상 있습니다.
NETWORK_ALIVE_WAN
컴퓨터에 하나 이상의 활성 RAS 연결이 있습니다.
반환 값
이 함수의 반환 코드를 확인하기 전에 항상 GetLastError 를 호출합니다. 마지막 오류가 0이 아니면 IsNetworkAlive 함수가 실패하고 다음 TRUE 및 FALSE 값이 적용되지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
마지막 오류가 0이고 함수가 TRUE를 반환하는 경우 SENS는 로컬 시스템이 네트워크에 연결되어 있음을 확인했습니다.
연결 유형에 대한 자세한 내용은 lpdwFlags 매개 변수를 참조하세요. |
|
마지막 오류가 0이고 함수가 FALSE를 반환하는 경우 SENS는 연결이 없음을 확인했습니다. |
설명
Windows Vista 및 Windows Server 2008용으로 설계된 애플리케이션부터 개발자는 이 함수 대신 네트워크 목록 관리자 를 사용하는 것이 좋습니다.
이 함수는 애플리케이션에서 네트워크 작업을 계속하기 전에 네트워크 연결이 있는지 여부를 확인하는 데 사용할 수 있습니다. 애플리케이션, 전자 메일 클라이언트 또는 인터넷 브라우저의 디렉터리 서비스 유형은 다양한 유형의 네트워크 연결에 맞게 조정할 수 있습니다. 예를 들어 네트워크 연결을 사용할 수 있을 때까지 인쇄 작업을 연기할 수 있습니다.
IsNetworkAlive가 느릴 수 있고 함수가 로컬 시스템의 연결이 끊어지는 것을 감지하는 데 너무 많은 시간이 걸릴 수 있으므로 애플리케이션에서 ISNetworkAlive를 호출하여 로컬 시스템의 연결이 끊어지는지 여부를 확인하는 것이 항상 실용적이지 않을 수 있습니다. 그러나 IsNetworkAlive 는 항상 현재 WAN 연결을 식별할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | sensapi.h |
| 라이브러리 | Sensapi.lib |
| DLL | Sensapi.dll |