Función NdfRepairIncident (ndfapi.h)

  • Artículo

La función NdfRepairIncident repara un incidente sin mostrar una interfaz de usuario.

Sintaxis

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

Parámetros

[in] Handle

Tipo: NDFHANDLE

Controle el incidente de Network Diagnostics Framework. Este identificador debe coincidir con el identificador pasado a NdfDiagnoseIncident.

[in] RepairEx

Tipo: RepairInfoEx*

Estructura (obtenida de NdfDiagnoseIncident) que indica la reparación concreta que se va a realizar.

La memoria asignada a estas estructuras debe liberarse más adelante. Para obtener un ejemplo de cómo hacerlo, consulte Los ejemplos de diagnóstico de red de Microsoft Windows.

dwWait

Tipo: DWORD

El período de tiempo, en milisegundos, que se esperará antes de finalizar la rutina de diagnóstico. INFINITE se puede pasar a este parámetro si no se desea ningún tiempo de espera.

Valor devuelto

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

Código devuelto Descripción
S_OK
 La reparación se realizó correctamente.
NDF_E_VALIDATION
 La reparación se ejecutó correctamente, pero la validación de NDF todavía encontró un problema de conectividad. Si se devuelve este valor, la sesión debe cerrarse llamando a NdfCloseIncident y se debe crear otra sesión para continuar con el diagnóstico.
E_HANDLE
 El identificador de incidente de NDF no es válido.
WAIT_TIMEOUT
 La operación de reparación ha finalizado porque ha tardado más tiempo que el tiempo de espera especificado en dwWait.
 

Se devuelven otros códigos de error si la reparación no se pudo ejecutar. En ese caso, el cliente puede llamar a NdfRepairIncident de nuevo con una reparación diferente.

Comentarios

NdfRepairIncident solo se puede llamar cuando se usa NdfDiagnoseIncident para diagnósticos. Normalmente, este es el caso en escenarios en los que no se muestra ninguna interfaz de usuario o donde no se usa la experiencia estándar de Windows (como con Media Center y aplicaciones insertadas). No se debe llamar a NdfRepairIncident cuando se usa NdfExecuteDia diagnostic.

Antes de usar esta API, una aplicación debe llamar a una función de creación de incidentes como NdfCreateWebIncident para iniciar el proceso de diagnóstico de NDF. A continuación, la aplicación llama a NdfDiagnoseIncident para diagnosticar el problema. Si el proceso de diagnóstico identifica algunas reparaciones posibles, la aplicación puede llamar a NdfRepairIncident para reparar el problema sin mostrar una interfaz de usuario. Opcionalmente, se puede llamar a NdfCancelIncident desde un subproceso independiente si la aplicación quiere cancelar una llamada de NdfRepairIncident en curso. Por último, la aplicación llama a NdfCloseIncident.

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

Consulte también

NdfDiagnoseIncident

RepairInfoEx