通过

NdfCreateInboundIncident 函数 (ndfapi.h)

  • 项目

NdfCreateInboundIncident 函数创建会话来诊断特定应用程序或服务的入站连接。

语法

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

参数

[in, optional] applicationID

类型： LPCWSTR

接收入站流量的应用程序的完全限定路径。

[in, optional] serviceID

类型： LPCWSTR

接收入站流量的 Windows 服务。

dll，-28502 (文件/打印共享)
dll，-28752 (远程桌面)
dll，-32752 (Network Discovery)

[in, optional] userID

类型： SID*

接收流量的应用程序的 SID。 如果 为 NULL，则会自动使用调用方 SID。

[in, optional] localTarget

类型： const SOCKADDR_STORAGE

一种SOCKADDR_STORAGE结构，用于将诊断限制为发到特定 IP 地址的流量。 如果 为 NULL，则所有流量都将包含在诊断中。

protocol

类型： IPPROTO

应诊断的协议。 例如，IPPROTO_TCP将用于指示 TCP/IP 协议。

dwFlags

类型：DWORD

可能的值：

NDF_INBOUND_FLAG_EDGETRAVERSAL

指示如果本地网络上的两个网关都在专用访问范围内，应将配置视为不正常，而不是仅当两个网关都是 Internet 网关设备 (IGD) 时才认为配置正常。

NDF_INBOUND_FLAG_HEALTHCHECK

如果未诊断任何入站流量问题，则立即结束会话，而不是启用详细跟踪并允许用户重现其问题进行第二次诊断。

[out] handle

类型： NDFHANDLE*

指向网络诊断框架事件的句柄的指针。

返回值

类型： HRESULT

可能的返回值包括但不限于以下内容。

返回代码 说明
S_OK
 操作成功。
E_INVALIDARG
 未正确提供一个或多个参数。

注解

必须指定 applicationID 或 serviceID ，但不能同时指定这两者。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 ndfapi.h
Library Ndfapi.lib
DLL Ndfapi.dll