Функция 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*

Идентификатор безопасности для приложения, получающего трафик. Если значение РАВНО NULL, идентификатор безопасности вызывающего абонента используется автоматически.

[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
Header	ndfapi.h
Библиотека	Ndfapi.lib
DLL	Ndfapi.dll