共用方式為

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 (網路探索)

[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

指出如果局域網路上的兩個網關都在私人存取範圍內，則應該將設定視為狀況不良，而不只是將兩個網關都視為因特網網關裝置 (IGD) 時，設定才會處於狀況良好狀態。

NDF_INBOUND_FLAG_HEALTHCHECK

如果未診斷任何輸入流量問題，請立即結束會話，而不是開啟詳細的追蹤，並允許使用者針對第二次診斷重現其問題。

[out] handle

類型： NDFHANDLE*

網路診斷架構事件的句柄指標。

傳回值

類型： HRESULT

可能的傳回值包括，但不限於下列各項。

傳回碼 描述
S_OK
 作業成功。
E_INVALIDARG
 尚未正確提供一或多個參數。

備註

必須指定 applicationID 或 serviceID ，但不能同時指定兩者。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 ndfapi.h
程式庫 Ndfapi.lib
Dll Ndfapi.dll