Compartilhar via

Função NdfCreateGroupingIncident (ndfapi.h)

  • Artigo

A função NdfCreateGroupingIncident cria uma sessão para diagnosticar problemas de funcionalidade de agrupamento ponto a ponto.

Sintaxe

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

O nome da nuvem PNRP (Peer Name Resolution Protocol) em que o grupo é criado. Se FOR NULL, a sessão não tentará diagnosticar problemas relacionados ao PNRP.

[in, optional] GroupName

Tipo: LPCWSTR

O nome do grupo a ser diagnosticado. Se FOR NULL, a sessão não tentará diagnosticar problemas relacionados à disponibilidade do grupo.

[in, optional] Identity

Tipo: LPCWSTR

A identidade que um par usa para acessar o grupo. Se FOR NULL, a sessão não tentará diagnosticar problemas relacionados à capacidade do grupo de se registrar no PNRP.

[in, optional] Invitation

Tipo: LPCWSTR

Um convite XML concedido por outro par. Um convite é criado quando o par convidativo chama PeerGroupCreateInvitation ou PeerGroupIssueCredentials. Se esse valor estiver presente, o convite será verificado para garantir que seu formato e expiração sejam válidos.

[in, optional] Addresses

Tipo: SOCKET_ADDRESS_LIST*

Lista opcional de endereços dos pares aos quais o aplicativo está tentando se conectar. Se esse parâmetro for usado, a classe auxiliar diagnosticará a conectividade com esses endereços.

[in, optional] appId

Tipo: LPCWSTR

ID do aplicativo para o aplicativo de chamada.

[out] handle

Tipo: NDFHANDLE*

Manipule para o incidente da Estrutura de Diagnóstico de Rede.

Retornar valor

Tipo: HRESULT

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
NDF_E_BAD_PARAM
 Um ou mais parâmetros não foram fornecidos corretamente.

Comentários

O nível de diagnóstico executado depende dos parâmetros fornecidos.

  • Se nenhum parâmetro for especificado, o NDF validará o serviço de agrupamento status, o status de serviços ponto a ponto (PNRP e Identity Manager) e sincronização de relógio do Windows.
  • Se CloudName for especificado, o NDF validará a funcionalidade de agrupamento nessa nuvem.
  • Se GroupName for especificado, o NDF validará se o nome pode ser resolvido em PNRP (ou invocará a classe auxiliar PNRP se o nome não puder ser resolvido) e validará as configurações de firewall para agrupamento.
  • Se Identity for especificado, o NDF validará a capacidade do PNRP de registrar o GroupName com essa Identidade. Se isso falhar, a classe auxiliar PNRP será invocada.
  • Se Invitation for especificado, GroupName será derivado do Convite (se um GroupName também não tiver sido especificado) e o NDF validará o formato e o status do convite.
  • Se Addresses for especificado, o NDF validará se o Windows pode se conectar a até três desses endereços.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ndfapi.h
Biblioteca Ndfapi.lib
DLL Ndfapi.dll