NdfDiagnoseIncident 함수(ndfapi.h)

NdfDiagnoseIncident 함수는 사용자 인터페이스를 표시하지 않고 인시던트의 근본 원인을 진단합니다.

구문

void NdfDiagnoseIncident(
  [in]  NDFHANDLE     Handle,
  [out] ULONG         *RootCauseCount,
  [out] RootCauseInfo **RootCauses,
        DWORD         dwWait,
        DWORD         dwFlags
);

매개 변수

[in] Handle

형식: NDFHANDLE

네트워크 진단 프레임워크 인시던트에 대한 핸들입니다.

[out] RootCauseCount

형식: ULONG*

이 인시던트가 발생할 수 있는 근본 원인의 수입니다. 진단에 성공하지 못하면 이 매개 변수의 내용을 무시해야 합니다.

[out] RootCauses

형식: RootCauseInfo**

근본 원인에 대한 자세한 설명을 포함하는 RootCauseInfo 구조체의 컬렉션입니다. 진단에 성공하면 이 매개 변수에는 진단 세션에서 식별된 리프 루트 원인과 사용 가능한 복구가 있는 리프가 아닌 근본 원인이 모두 포함됩니다. 진단에 성공하지 못하면 이 매개 변수의 내용을 무시해야 합니다.

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

dwWait

형식:DWORD

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

dwFlags

형식:DWORD

가능한 값은 다음과 같습니다.

반환 값

형식: HRESULT

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

설명

이 함수는 사용자 인터페이스가 표시되지 않거나 표준 Windows 환경이 사용되지 않는 시나리오(Media Center 및 포함된 애플리케이션과 마찬가지로)에서 사용하기 위한 것입니다. NdfExecuteDiagnosis는 진단 사용자 인터페이스를 시작하며 표준 Windows 환경을 사용하는 시나리오에서 사용해야 합니다. NdfExecuteDiagnosis 또는 NdfDiagnoseIncident를 호출할 수 있지만 둘 다 호출할 수는 없습니다.

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

다음 표에서는 근본 원인 및 해당 복구의 몇 가지 예를 보여 줍니다.

요구 사항

추가 정보

NdfExecuteDiagnosis

NdfGetTraceFile

RootCauseInfo