Función IsDestinationReachableA (sensapi.h)

La función isDestinationReachable determina si se puede alcanzar o no un destino especificado y proporciona información de calidad de conexión (QOC) para un destino.

Windows Vista y versiones posteriores, Windows Server 2008 y versiones posteriores: Esta función no se admite y siempre devuelve ERROR_CALL_NOT_IMPLEMENTED.

Sintaxis

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

Parámetros

[in] lpszDestination

Puntero a un cadena terminada en nullque especifica un destino. El destino puede ser una dirección IP, un nombre UNC o una dirección URL.

[in, out] lpQOCInfo

Puntero a la estructura de QOCINFO que recibe la información de calidad de conexión (QOC). Puede proporcionar un puntero NULL si no desea recibir la información de QOC.

Valor devuelto

Código devuelto	Descripción
TRUE	Se puede acceder a un destino.
FALSE	No se puede acceder a un destino. Para obtener información de error extendida, llame a GetLastError.
ERROR_CALL_NOT_IMPLEMENTED	Esta función no está disponible en Windows Vista.

Observaciones

Las aplicaciones cliente usan esta función para determinar la información de QOC antes de continuar con las operaciones de red. Para equipos independientes que están conectados directamente a una red a través de una tarjeta de red o un servidor de acceso remoto (RAS), esta función genera un tráfico de red mínimo con llamadas RPC al enrutador más cercano. En el caso de los equipos que forman parte de una red donde se puede acceder a un destino mediante RAS o una puerta de enlace de red, esta función hace ping a un destino para generar información precisa de QOC.

Esta función solo está disponible para las conexiones TCP/IP. Un autor de llamada proporciona el búfer para la estructura QOCINFO de y debe liberar la memoria cuando no sea necesario.

A partir de las aplicaciones diseñadas para Windows Vista y Windows Server 2008, los desarrolladores deben considerar el uso de la Network List Manager en lugar de esta función.

Nota

El encabezado sensapi.h define IsDestinationReachable como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	sensapi.h
biblioteca de	Sensapi.lib
DLL de	Sensapi.dll

Consulte también

Acerca del servicio de notificaciones de eventos del sistema

IsNetworkAlive

QOCINFO