Compartilhar via

Função NdfRepairIncident (ndfapi.h)

  • Artigo

A função NdfRepairIncident repara um incidente sem exibir uma interface do usuário.

Sintaxe

void NdfRepairIncident(
  [in] NDFHANDLE    Handle,
  [in] RepairInfoEx *RepairEx,
       DWORD        dwWait
);

Parâmetros

[in] Handle

Tipo: NDFHANDLE

Identificador para o incidente da Estrutura de Diagnóstico de Rede. Esse identificador deve corresponder ao identificador passado para NdfDiagnoseIncident.

[in] RepairEx

Tipo: RepairInfoEx*

Uma estrutura (obtida de NdfDiagnoseIncident) que indica o reparo específico a ser executado.

A memória alocada para essas estruturas deve ser liberada posteriormente. Para obter um exemplo de como fazer isso, consulte Os Exemplos de Diagnóstico de Rede do Microsoft Windows.

dwWait

Tipo: DWORD

O período de tempo, em milissegundos, para aguardar antes de encerrar a rotina de diagnóstico. INFINITE poderá ser passado para esse parâmetro se nenhum tempo limite for desejado.

Retornar valor

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

Código de retorno Descrição
S_OK
 Reparo bem-sucedido.
NDF_E_VALIDATION
 O reparo foi executado com êxito, mas a validação do NDF ainda encontrou um problema de conectividade. Se esse valor for retornado, a sessão deverá ser fechada chamando NdfCloseIncident e outra sessão deverá ser criada para continuar o diagnóstico.
E_HANDLE
 O identificador de incidente NDF não é válido.
WAIT_TIMEOUT
 A operação de reparo foi encerrada porque demorou mais do que o tempo limite especificado em dwWait.
 

Outros códigos de falha serão retornados se o reparo não for executado. Nesse caso, o cliente pode chamar NdfRepairIncident novamente com um reparo diferente.

Comentários

NdfRepairIncident só pode ser chamado quando NdfDiagnoseIncident é usado para diagnóstico. Normalmente, esse é o caso em cenários em que nenhuma interface do usuário é mostrada ou em que a experiência padrão do Windows não está sendo usada (como acontece com o Media Center e aplicativos inseridos). NdfRepairIncident não deve ser chamado quando NdfExecuteDiagnosis é usado.

Antes de usar essa API, um aplicativo deve chamar uma função de criação de incidente, como NdfCreateWebIncident, para iniciar o processo de diagnóstico do NDF. Em seguida, o aplicativo chama NdfDiagnoseIncident para diagnosticar o problema. Se o processo de diagnóstico identificar alguns reparos possíveis, o aplicativo poderá chamar NdfRepairIncident para reparar o problema sem exibir uma interface do usuário. NdfCancelIncident pode, opcionalmente, ser chamado de um thread separado se o aplicativo quiser cancelar uma chamada NdfRepairIncident em andamento. Por fim, o aplicativo chama NdfCloseIncident.

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

Confira também

NdfDiagnoseIncident

RepairInfoEx