Compartilhar via

Função NdfCreateInboundIncident (ndfapi.h)

  • Artigo

A função NdfCreateInboundIncident cria uma sessão para diagnosticar a conectividade de entrada para um aplicativo ou serviço específico.

Sintaxe

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

Parâmetros

[in, optional] applicationID

Tipo: LPCWSTR

O caminho totalmente qualificado para o aplicativo que recebe o tráfego de entrada.

[in, optional] serviceID

Tipo: LPCWSTR

O serviço Windows que recebe o tráfego de entrada.

dll,-28502 (Compartilhamento de arquivo/impressão)
dll,-28752 (Área de Trabalho Remota)
dll,-32752 (Descoberta de Rede)

[in, optional] userID

Tipo: SID*

O SID do aplicativo que recebe o tráfego. Se FOR NULL, o SID do chamador será usado automaticamente.

[in, optional] localTarget

Tipo: const SOCKADDR_STORAGE

Uma estrutura SOCKADDR_STORAGE que limita o diagnóstico ao tráfego para um endereço IP específico. Se FOR NULL, todo o tráfego será incluído no diagnóstico.

protocol

Tipo: IPPROTO

O protocolo que deve ser diagnosticado. Por exemplo, IPPROTO_TCP seria usado para indicar o protocolo TCP/IP.

dwFlags

Tipo: DWORD

Valores possíveis:

NDF_INBOUND_FLAG_EDGETRAVERSAL

Indica que uma configuração deve ser considerada não íntegra se ambos os gateways na rede local estiverem dentro do intervalo de acesso privado, em vez de considerar apenas a configuração como íntegra se ambos os gateways forem IGDs (Dispositivos de Gateway de Internet).

NDF_INBOUND_FLAG_HEALTHCHECK

Encerra a sessão imediatamente se nenhum problema de tráfego de entrada for diagnosticado, em vez de ativar o rastreamento detalhado e permitir que o usuário reproduza o problema para um segundo diagnóstico.

[out] handle

Tipo: NDFHANDLE*

Ponteiro para um identificador para o incidente da Estrutura de Diagnóstico de Rede.

Retornar valor

Tipo: HRESULT

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

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

Comentários

ApplicationID ou serviceID devem ser especificados, mas não ambos.

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