Поделиться через

Функция NdfCreateGroupingIncident (ndfapi.h)

  • Статья

Функция NdfCreateGroupingIncident создает сеанс для диагностики проблем с функциональностью одноранговой группировки.

Синтаксис

HRESULT NdfCreateGroupingIncident(
  [in, optional] LPCWSTR             CloudName,
  [in, optional] LPCWSTR             GroupName,
  [in, optional] LPCWSTR             Identity,
  [in, optional] LPCWSTR             Invitation,
  [in, optional] SOCKET_ADDRESS_LIST *Addresses,
  [in, optional] LPCWSTR             appId,
  [out]          NDFHANDLE           *handle
);

Параметры

[in, optional] CloudName

Тип: LPCWSTR

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

[in, optional] GroupName

Тип: LPCWSTR

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

[in, optional] Identity

Тип: LPCWSTR

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

[in, optional] Invitation

Тип: LPCWSTR

XML-приглашение, предоставленное другим одноранговым элементом. Приглашение создается, когда приглашающий одноранговый узел вызывает PeerGroupCreateInvitation или PeerGroupIssueCredentials. Если это значение присутствует, приглашение будет проверено, чтобы убедиться, что его формат и срок действия действительны.

[in, optional] Addresses

Тип: SOCKET_ADDRESS_LIST*

Необязательный список адресов одноранговых узлов, к которым приложение пытается подключиться. Если этот параметр используется, вспомогательный класс будет диагностировать подключение к этим адресам.

[in, optional] appId

Тип: LPCWSTR

Идентификатор приложения для вызывающего приложения.

[out] handle

Тип: NDFHANDLE*

Обработка инцидента платформы диагностики сети.

Возвращаемое значение

Тип: HRESULT

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата Описание
S_OK
 Операция успешно выполнена.
NDF_E_BAD_PARAM
 Один или несколько параметров указаны неправильно.

Комментарии

Уровень выполняемой диагностики зависит от предоставленных параметров.

  • Если параметры не указаны, NDF проверит состояние службы группирования, состояние одноранговых служб (PNRP и Identity Manager) и синхронизацию часов Windows.
  • Если указано Значение CloudName , NDF проверит функциональные возможности группирования в этом облаке.
  • Если указан параметр GroupName , NDF проверит, можно ли разрешить имя в PNRP (или вызовет вспомогательный класс PNRP, если имя не удается разрешить), и проверит параметры брандмауэра для группирования.
  • Если указано удостоверение , NDF проверит возможность регистрации GroupName с помощью этого удостоверения. Если это не удается, будет вызван вспомогательный класс PNRP.
  • Если указано приглашение , groupName будет получено от приглашения (если имя группы также не указано), а NDF проверит формат и состояние приглашения.
  • Если указан параметр Адреса , NDF проверит, может ли Windows подключаться к трем из этих адресов.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header ndfapi.h
Библиотека Ndfapi.lib
DLL Ndfapi.dll