다음을 통해 공유

NdfRepairIncident 함수(ndfapi.h)

  • 아티클

NdfRepairIncident 함수는 사용자 인터페이스를 표시하지 않고 인시던트를 복구합니다.

구문

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

매개 변수

[in] Handle

형식: NDFHANDLE

네트워크 진단 프레임워크 인시던트에 대한 핸들입니다. 이 핸들은 NdfDiagnoseIncident에 전달된 핸들과 일치해야 합니다.

[in] RepairEx

형식: RepairInfoEx*

수행할 특정 복구를 나타내는 구조체( NdfDiagnoseIncident에서 가져온)입니다.

이러한 구조체에 할당된 메모리는 나중에 해제되어야 합니다. 이 작업을 수행하는 방법에 대한 예제는 Microsoft Windows 네트워크 진단 샘플을 참조하세요.

dwWait

형식:DWORD

진단 루틴을 종료하기 전에 대기할 시간(밀리초)입니다. 시간 제한이 필요한 경우 INFINITE가 이 매개 변수에 전달될 수 있습니다.

반환 값

가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.

반환 코드 Description
S_OK
 복구에 성공했습니다.
NDF_E_VALIDATION
 복구가 성공적으로 실행되었지만 NDF 유효성 검사에서 여전히 연결 문제가 발견되었습니다. 이 값이 반환되면 NdfCloseIncident 를 호출하여 세션을 닫아야 하며 진단을 계속하려면 다른 세션을 만들어야 합니다.
E_HANDLE
 NDF 인시던트 핸들이 잘못되었습니다.
WAIT_TIMEOUT
 dwWait에 지정된 제한 시간보다 오래 걸리기 때문에 복구 작업이 종료되었습니다.
 

복구를 실행하지 못한 경우 다른 오류 코드가 반환됩니다. 이 경우 클라이언트는 다른 복구를 사용하여 NdfRepairIncident 를 다시 호출할 수 있습니다.

설명

NdfRepairIncident는 NdfDiagnoseIncident가 진단 사용되는 경우에만 호출할 수 있습니다. 이는 일반적으로 사용자 인터페이스가 표시되지 않거나 표준 Windows 환경이 사용되지 않는 시나리오의 경우입니다(Media Center 및 포함된 애플리케이션과 마찬가지로). NdfExecuteDiagnosis를 사용할 때 NdfRepairIncident를 호출하면 안 됩니다.

이 API를 사용하기 전에 애플리케이션은 NdfCreateWebIncident와 같은 인시던트 생성 함수를 호출하여 NDF 진단 프로세스를 시작해야 합니다. 그런 다음, 애플리케이션은 NdfDiagnoseIncident 를 호출하여 문제를 진단합니다. 진단 프로세스에서 몇 가지 가능한 복구를 식별하는 경우 애플리케이션은 NdfRepairIncident를 호출하여 사용자 인터페이스를 표시하지 않고 문제를 복구할 수 있습니다. 애플리케이션이 진행 중인 NdfRepairIncident 호출을 취소하려는 경우 필요에 따라 별도의 스레드에서 NdfCancelIncident를 호출할 수 있습니다. 마지막으로 애플리케이션은 NdfCloseIncident를 호출합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 ndfapi.h
라이브러리 Ndfapi.lib
DLL Ndfapi.dll

추가 정보

NdfDiagnoseIncident

RepairInfoEx