Función NdfCreateGroupingIncident (ndfapi.h)

La función NdfCreateGroupingIncident crea una sesión para diagnosticar problemas de funcionalidad de agrupación punto a punto.

Sintaxis

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

Parámetros

[in, optional] CloudName

Tipo: LPCWSTR

Nombre de la nube del Protocolo de resolución de nombres del mismo nivel (PNRP) donde se crea el grupo. Si es NULL, la sesión no intentará diagnosticar problemas relacionados con PNRP.

[in, optional] GroupName

Tipo: LPCWSTR

Nombre del grupo que se va a diagnosticar. Si es NULL, la sesión no intentará diagnosticar problemas relacionados con la disponibilidad del grupo.

[in, optional] Identity

Tipo: LPCWSTR

Identidad que un elemento del mismo nivel usa para acceder al grupo. Si es NULL, la sesión no intentará diagnosticar problemas relacionados con la capacidad del grupo de registrarse en PNRP.

[in, optional] Invitation

Tipo: LPCWSTR

Una invitación XML concedida por otro elemento del mismo nivel. Se crea una invitación cuando el elemento del mismo nivel que invita llama a PeerGroupCreateInvitation o PeerGroupIssueCredentials. Si este valor está presente, se comprobará la invitación para asegurarse de que su formato y expiración sean válidos.

[in, optional] Addresses

Tipo: SOCKET_ADDRESS_LIST*

Lista opcional de direcciones de los elementos del mismo nivel a las que la aplicación intenta conectarse. Si se usa este parámetro, la clase auxiliar diagnosticará la conectividad con estas direcciones.

[in, optional] appId

Tipo: LPCWSTR

Id. de aplicación para la aplicación que llama.

[out] handle

Tipo: NDFHANDLE*

Controle el incidente de Network Diagnostics Framework.

Valor devuelto

Tipo: HRESULT

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
NDF_E_BAD_PARAM	Uno o varios parámetros no se han proporcionado correctamente.

Comentarios

El nivel de diagnóstico realizado depende de los parámetros proporcionados.

• Si no se especifica ningún parámetro, NDF validará el estado del servicio de agrupación, el estado de los servicios punto a punto (PNRP y Identity Manager) y la sincronización del reloj de Windows.
• Si se especifica CloudName , NDF validará la funcionalidad de agrupación en esa nube.
• Si se especifica GroupName , NDF validará que el nombre se puede resolver en PNRP (o invocar la clase auxiliar PNRP si no se puede resolver el nombre) y validará la configuración del firewall para la agrupación.
• Si se especifica Identity , NDF validará la capacidad de PNRP de registrar groupName con esta identidad. Si se produce un error, se invocará la clase auxiliar PNRP.
• Si se especifica Invitation , groupName se derivará de la invitación (si no se especificó un groupName ) y NDF validará el formato y el estado de la invitación.
• Si se especifica Addresses , NDF validará si Windows puede conectarse a hasta tres de estas direcciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ndfapi.h
Library	Ndfapi.lib
Archivo DLL	Ndfapi.dll