Función NdfCreateInboundIncident (ndfapi.h)

La función NdfCreateInboundIncident crea una sesión para diagnosticar la conectividad entrante para una aplicación o servicio específico.

Sintaxis

void NdfCreateInboundIncident(
  [in, optional] LPCWSTR                applicationID,
  [in, optional] LPCWSTR                serviceID,
  [in, optional] SID                    *userID,
  [in, optional] const SOCKADDR_STORAGE *localTarget,
                 IPPROTO                protocol,
                 DWORD                  dwFlags,
  [out]          NDFHANDLE              *handle
);

Parámetros

[in, optional] applicationID

Tipo: LPCWSTR

Ruta de acceso completa a la aplicación que recibe el tráfico entrante.

[in, optional] serviceID

Tipo: LPCWSTR

Servicio de Windows que recibe el tráfico entrante.

dll,-28502 (Uso compartido de archivos/impresión)

dll,-28752 (Escritorio remoto)

dll,-32752 (Detección de redes)

[in, optional] userID

Tipo: SID*

SID de la aplicación que recibe el tráfico. Si es NULL, se usa automáticamente el SID del autor de la llamada.

[in, optional] localTarget

Tipo: const SOCKADDR_STORAGE

Estructura SOCKADDR_STORAGE que limita el diagnóstico al tráfico a una dirección IP específica. Si es NULL, todo el tráfico se incluirá en el diagnóstico.

protocol

Tipo: IPPROTO

Protocolo que se debe diagnosticar. Por ejemplo, IPPROTO_TCP se usaría para indicar el protocolo TCP/IP.

dwFlags

Tipo: DWORD

Valores posibles:

NDF_INBOUND_FLAG_EDGETRAVERSAL

Indica que una configuración debe considerarse incorrecta si ambas puertas de enlace de la red local están dentro del intervalo de acceso privado, en lugar de considerar que la configuración es correcta si ambas puertas de enlace son dispositivos de puerta de enlace de Internet (IGD).

NDF_INBOUND_FLAG_HEALTHCHECK

Finaliza la sesión inmediatamente si no se diagnostica ningún problema de tráfico entrante, en lugar de activar el seguimiento detallado y permitir que el usuario reproduzca su problema para un segundo diagnóstico.

[out] handle

Tipo: NDFHANDLE*

Puntero a un identificador del incidente de Network Diagnostics Framework.

Valor devuelto

Tipo: HRESULT

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_INVALIDARG	Uno o varios parámetros no se han proporcionado correctamente.

Comentarios

Se debe especificar applicationID o serviceID , pero no ambos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ndfapi.h
Library	Ndfapi.lib
Archivo DLL	Ndfapi.dll