NdfCreateInboundIncident-Funktion (ndfapi.h)

Die NdfCreateInboundIncident-Funktion erstellt eine Sitzung, um eingehende Konnektivität für eine bestimmte Anwendung oder einen bestimmten Dienst zu diagnostizieren.

Syntax

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

Parameter

[in, optional] applicationID

Typ: LPCWSTR

Der vollqualifizierte Pfad zur Anwendung, die den eingehenden Datenverkehr empfängt.

[in, optional] serviceID

Typ: LPCWSTR

Der Windows-Dienst, der den eingehenden Datenverkehr empfängt.

dll,-28502 (Datei-/Druckfreigabe)

dll,-28752 (Remotedesktop)

dll,-32752 (Netzwerkermittlung)

[in, optional] userID

Typ: SID*

Die SID für die Anwendung, die den Datenverkehr empfängt. Wenn NULL, wird die SID des Aufrufers automatisch verwendet.

[in, optional] localTarget

Typ: const SOCKADDR_STORAGE

Eine SOCKADDR_STORAGE Struktur, die die Diagnose auf Datenverkehr an eine bestimmte IP-Adresse beschränkt. Bei NULL wird der gesamte Datenverkehr in die Diagnose einbezogen.

protocol

Typ: IPPROTO

Das Protokoll, das diagnostiziert werden soll. Beispielsweise wird IPPROTO_TCP verwendet, um das TCP/IP-Protokoll anzugeben.

dwFlags

Art: DWORD

Mögliche Werte:

NDF_INBOUND_FLAG_EDGETRAVERSAL

Gibt an, dass eine Konfiguration als fehlerhaft angesehen werden sollte, wenn sich beide Gateways im lokalen Netzwerk innerhalb des privaten Zugriffsbereichs befinden, anstatt die Konfiguration nur als fehlerfrei zu betrachten, wenn es sich bei beiden Gateways um Internetgatewaygeräte (INTERNET Gateway Devices, IGDs) handelt.

NDF_INBOUND_FLAG_HEALTHCHECK

Beendet die Sitzung sofort, wenn keine Probleme mit eingehendem Datenverkehr diagnostiziert werden, anstatt die detaillierte Ablaufverfolgung zu aktivieren und dem Benutzer die Möglichkeit zu geben, sein Problem für eine zweite Diagnose zu reproduzieren.

[out] handle

Typ: NDFHANDLE*

Zeiger auf ein Handle auf den Network Diagnostics Framework-Incident.

Rückgabewert

Typ: HRESULT

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_INVALIDARG	Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.

Hinweise

Es muss entweder applicationID oder serviceID angegeben werden, aber nicht beides.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ndfapi.h
Bibliothek	Ndfapi.lib
DLL	Ndfapi.dll