다음을 통해 공유

IsDestinationReachableA 함수(sensapi.h)

  • 아티클

IsDestinationReachable 함수는 지정된 대상에 연결할 수 있는지 여부를 결정하고 대상에 대한 QOC(연결 품질) 정보를 제공합니다.

Windows Vista 이상 Windows Server 2008 이상: 이 함수는 지원되지 않으며 항상 ERROR_CALL_NOT_IMPLEMENTED반환합니다.

통사론

BOOL IsDestinationReachableA(
  [in]      LPCSTR    lpszDestination,
  [in, out] LPQOCINFO lpQOCInfo
);

매개 변수

[in] lpszDestination

대상을 지정하는 null종료된 문자열에 대한 포인터입니다. 대상은 IP 주소, UNC 이름 또는 URL일 수 있습니다.

[in, out] lpQOCInfo

QOC(연결 품질) 정보를 수신하는 QOCINFO 구조체에 대한 포인터입니다. QOC 정보를 받지 않으려면 NULL 포인터를 제공할 수 있습니다.

반환 값

반환 코드 묘사
TRUE
 대상에 연결할 수 있습니다.
FALSE
대상에 연결할 수 없습니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
ERROR_CALL_NOT_IMPLEMENTED
 이 함수는 Windows Vista에서 사용할 수 없습니다.

발언

클라이언트 애플리케이션은 네트워크 작업을 계속하기 전에 이 함수를 사용하여 QOC 정보를 확인합니다. 네트워크 카드 또는 RAS(원격 액세스 서버)를 통해 네트워크에 직접 연결된 독립 실행형 컴퓨터의 경우 이 함수는 가장 가까운 라우터에 대한 RPC 호출을 사용하여 최소한의 네트워크 트래픽을 생성합니다. RAS 또는 네트워크 게이트웨이를 사용하여 대상에 연결할 수 있는 네트워크의 일부인 컴퓨터의 경우 이 함수는 대상을 ping하여 정확한 QOC 정보를 생성합니다.

이 함수는 TCP/IP 연결에만 사용할 수 있습니다. 호출자는 QOCINFO 구조에 대한 버퍼를 제공하고 필요하지 않은 경우 메모리를 해제해야 합니다.

Windows Vista 및 Windows Server 2008용으로 설계된 애플리케이션부터 개발자는 이 함수 대신 네트워크 목록 관리자 사용하는 것이 좋습니다.

메모

sensapi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 IsDestinationReachable을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 sensapi.h
라이브러리 Sensapi.lib
DLL Sensapi.dll

참고 항목

시스템 이벤트 알림 서비스 대한

isNetworkAlive

QOCINFO