Condividi tramite

Funzione NdfCreateInboundIncident (ndfapi.h)

  • Articolo

La funzione NdfCreateInboundIncident crea una sessione per diagnosticare la connettività in ingresso per un'applicazione o un servizio specifico.

Sintassi

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
);

Parametri

[in, optional] applicationID

Tipo: LPCWSTR

Percorso completo dell'applicazione che riceve il traffico in ingresso.

[in, optional] serviceID

Tipo: LPCWSTR

Servizio Windows che riceve il traffico in ingresso.

dll,-28502 (condivisione file/stampa)
dll,-28752 (Desktop remoto)
dll,-32752 (individuazione di rete)

[in, optional] userID

Tipo: SID*

SID per l'applicazione che riceve il traffico. Se NULL, il SID del chiamante viene usato automaticamente.

[in, optional] localTarget

Tipo: const SOCKADDR_STORAGE

Struttura SOCKADDR_STORAGE che limita la diagnosi al traffico verso un indirizzo IP specifico. Se NULL, tutto il traffico verrà incluso nella diagnosi.

protocol

Tipo: IPPROTO

Protocollo da diagnosticare. Ad esempio, IPPROTO_TCP verrebbe usato per indicare il protocollo TCP/IP.

dwFlags

Tipo: DWORD

Valori possibili:

NDF_INBOUND_FLAG_EDGETRAVERSAL

Indica che una configurazione deve essere considerata non integra se entrambi i gateway nella rete locale si trovano all'interno dell'intervallo di accesso privato, anziché considerare la configurazione integra solo se entrambi i gateway sono dispositivi IGD (Internet Gateway Devices).

NDF_INBOUND_FLAG_HEALTHCHECK

Termina immediatamente la sessione se non vengono diagnosticati problemi di traffico in ingresso, anziché attivare la traccia dettagliata e consentire all'utente di riprodurre il problema per una seconda diagnosi.

[out] handle

Tipo: NDFHANDLE*

Puntatore a un handle per l'evento imprevisto di Network Diagnostics Framework.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_INVALIDARG
 Uno o più parametri non sono stati forniti correttamente.

Commenti

È necessario specificare applicationID o serviceID , ma non entrambi.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ndfapi.h
Libreria Ndfapi.lib
DLL Ndfapi.dll