Partager via

NdfCreateInboundIncident, fonction (ndfapi.h)

  • Article

La fonction NdfCreateInboundIncident crée une session pour diagnostiquer la connectivité entrante pour une application ou un service spécifique.

Syntaxe

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

Paramètres

[in, optional] applicationID

Type : LPCWSTR

Chemin d’accès complet à l’application recevant le trafic entrant.

[in, optional] serviceID

Type : LPCWSTR

Service Windows recevant le trafic entrant.

dll,-28502 (partage de fichiers/impression)
dll,-28752 (Bureau à distance)
dll,-32752 (découverte du réseau)

[in, optional] userID

Type : SID*

SID de l’application recevant le trafic. Si la valeur est NULL, le SID de l’appelant est automatiquement utilisé.

[in, optional] localTarget

Type : const SOCKADDR_STORAGE

Structure SOCKADDR_STORAGE qui limite le diagnostic au trafic vers une adresse IP spécifique. Si la valeur est NULL, tout le trafic est inclus dans le diagnostic.

protocol

Type : IPPROTO

Protocole qui doit être diagnostiqué. Par exemple, IPPROTO_TCP serait utilisé pour indiquer le protocole TCP/IP.

dwFlags

Type : DWORD

Valeurs possibles :

NDF_INBOUND_FLAG_EDGETRAVERSAL

Indique qu’une configuration doit être considérée comme non saine si les deux passerelles sur le réseau local se trouvent dans la plage d’accès privé, plutôt que de considérer uniquement la configuration comme étant saine si les deux passerelles sont des appareils de passerelle Internet (IGD).

NDF_INBOUND_FLAG_HEALTHCHECK

Termine la session immédiatement si aucun problème de trafic entrant n’est diagnostiqué, au lieu d’activer le suivi détaillé et de permettre à l’utilisateur de reproduire son problème pour un deuxième diagnostic.

[out] handle

Type : NDFHANDLE*

Pointeur vers un handle vers l’incident Network Diagnostics Framework.

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
S_OK
 L’opération a réussi.
E_INVALIDARG
 Un ou plusieurs paramètres n’ont pas été fournis correctement.

Remarques

ApplicationID ou serviceID doivent être spécifiés, mais pas les deux.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ndfapi.h
Bibliothèque Ndfapi.lib
DLL Ndfapi.dll