IDebugFAEntryTags::GetProperties 메서드(extsfns.h)

  • 아티클

GetProperties 메서드는 DebugFailureAnalysisTags 개체에서 태그의 이름 또는 설명(또는 둘 다)을 가져옵니다.

구문

HRESULT GetProperties(
            FA_TAG Tag,
  [out]     PSTR   Name,
  [in, out] PULONG NameSize,
  [out]     PSTR   Description,
  [in, out] PULONG DescSize,
  [out]     PULONG Flags
);

매개 변수

Tag

FA_TAG 열거형의 값입니다. 이 메서드는 이 태그의 이름 또는 설명(또는 둘 다)을 가져옵니다.

[out] Name

태그의 이름인 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다. NameSize가 태그 이름의 길이보다 작은 경우 이 메서드는 NULL 종결자를 포함한 NameSize 바이트만 이 버퍼에 복사합니다.

[in, out] NameSize

입력에서 이 매개 변수는 Name이 가리키는 버퍼의 크기(바이트)를 지정합니다. 출력 시 이 매개 변수는 태그 이름의 크기(바이트)를 받습니다. 태그에 이름이 없으면 이 매개 변수는 0 값을 받습니다.

참고Name 이 NULL이면 이 매개 변수는 정보를 받지 않습니다. Name과NameSize를 모두 NULL이 아닌 값으로 설정하거나 둘 다 NULL로 설정해야 합니다.
 

[out] Description

태그에 대한 설명인 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다. DescSize가 태그 설명의 길이보다 작은 경우 이 메서드는 NULL 종결자를 포함한 DescSize 바이트만 이 버퍼에 복사합니다.

[in, out] DescSize

입력에서 이 매개 변수는 Description이 가리키는 버퍼의 크기(바이트)를 지정 합니다. 출력 시 이 매개 변수는 태그 설명의 크기(바이트)를 받습니다. 태그에 설명이 없으면 이 매개 변수는 0 값을 받습니다.

참고Description 이 NULL이면 이 매개 변수는 정보를 수신하지 않습니다. Description과 DescSize를 모두 NULL이 아닌 값으로 설정하거나 둘 다 NULL로 설정해야 합니다.
 

[out] Flags

예약되어 있습니다. 이 매개 변수를 NULL로 설정합니다.

반환 값

이 메서드에서 반환된 HRESULT 값은 winerror.h 및 strsafe.h에 정의됩니다. 이 메서드에서 반환되는 값은 을 포함하지만 다음으로 제한되지는 않습니다.

반환 코드 Description
S_OK
 이 메서드는 요청된 이름 또는 설명(또는 둘 다)을 성공적으로 검색했으며 요청된 문자열이나 문자열을 잘림할 필요가 없었습니다.
STRSAFE_E_INSUFFICIENT_BUFFER
 이 메서드는 요청된 이름 또는 설명(또는 둘 다)을 검색했지만 이름이나 설명이 잘렸습니다.
STRSAFE_E_INVALID_PARAMETER
호출자가 하나 이상의 잘못된 매개 변수를 전달했습니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 extsfns.h

추가 정보

IDebugFAEntryTags

IDebugFailureAnalysis2

SetProperties

확장 !analyze에 대한 분석 확장 플러그 인 작성

_EFN_Analyze