IEnumCERTVIEWATTRIBUTE::GetName 메서드(certview.h)

아티클
02/23/2024

GetName 메서드는 특성 열거형 시퀀스에서 현재 특성의 이름을 검색합니다.

구문

HRESULT GetName(
  [out] BSTR *pstrOut
);

매개 변수

[out] pstrOut

특성의 이름을 포함하는 BSTR 형식의 변수에 대한 포인터입니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환하고 pstrOut 매개 변수에는 특성 이름이 포함됩니다.

이 메서드를 사용하려면 BSTR 형식의 변수를 만들고, 변수를 NULL로 설정하고, 이 변수의 주소를 pstrOut으로 전달합니다. BSTR 사용을 마쳤으면 SysFreeString 함수를 호출하여 해제합니다.

메서드가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

VB

반환 값은 특성의 이름을 포함하는 String 입니다.

설명

이 메서드는 특성 열거형 시퀀스에서 현재 참조하는 특성의 이름을 검색하는 데 사용됩니다.

특성 열거형 시퀀스가 유효한 특성을 참조하지 않으면 GetName 이 실패합니다. 다음 방법 중 하나를 사용하여 열거형을 탐색합니다.

IEnumCERTVIEWATTRIBUTE::Reset: 열거형 시퀀스의 시작 부분으로 이동합니다.
IEnumCERTVIEWATTRIBUTE::Next: 열거형 시퀀스의 다음 특성으로 이동합니다.
IEnumCERTVIEWATTRIBUTE::Skip: 지정된 수의 특성을 건너뜁니다.

예제

BSTR    bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
    printf("Failed call to GetName - %x\n", hr);
else
    printf("Attribute name is %ws\n", bstrAttribName );

// free memory when done
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certview.h(Certsrv.h 포함)
라이브러리	Certidl.lib
DLL	Certadm.dll