INetDiagHelper::GetAttributes 메서드(ndhelper.h)

GetAttributes 메서드는 도우미 클래스 확장에서 진단한 문제에 대한 추가 정보를 검색합니다.

구문

HRESULT GetAttributes(
  [out] ULONG            *pcelt,
  [out] HELPER_ATTRIBUTE **pprgAttributes
);

[out] pcelt

HELPER_ATTRIBUTE 배열의 요소 수에 대한 포인터입니다.

[out] pprgAttributes

HELPER_ATTRIBUTE 구조체 배열에 대한 포인터입니다.

반환 코드	Description
S_OK	작업에 성공했습니다.
E_OUTOFMEMORY	이 작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다.
E_INVALIDARG	하나 이상의 매개 변수가 올바르게 제공되지 않았습니다.
E_NOTIMPL	이 선택적 메서드는 구현되지 않습니다.
E_ACCESSDENIED	호출자에게 진단 또는 복구 작업을 수행할 수 있는 충분한 권한이 없습니다.
E_ABORT	진단 또는 복구 작업이 취소되었습니다.

도우미 클래스 확장은 함수에서 발생한 오류와 관련된 HRESULTS를 반환할 수 있습니다.

도우미 클래스 확장을 빌드할 때는 이 메서드가 필요하지 않습니다.

진단 및 복구 과정에서 도우미 클래스는 필요에 따라 NDF의 진단 처리를 개선하는 특성을 NDF에 반환할 수 있습니다. NDF로 반환할 수 있는 미리 정의된 특성은 다음과 같습니다.

용어	Description
werperameter(형식: AT_UINT32)	진단이 실패하면 추가 도우미 클래스 관련 WER(Windows 오류 보고) 버킷팅 매개 변수에 대한 선택적 특성입니다.
werfile(형식: AT_STRING)	WER(Windows 오류 보고) 보고서에 도우미 클래스별 파일을 추가하기 위한 선택적 특성입니다.
rootcauseid(Type: AT_GUID)	도우미 클래스는 한 번에 둘 이상의 문제를 진단할 수 있습니다. 확장에서 pszName 매개 변수가 rootcauseid로 설정된 AT_GUID 형식의 HelperAttribute를 반환하고 Guid 필드가 발생한 특정 문제를 식별하는 GUID로 설정된 경우 NDF에서 발생한 문제를 분석할 수 있습니다. 이러한 GUID는 도우미 확장에서 정의한 사용자 지정입니다.