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

아티클
02/26/2024

GetName 메서드는 extension-enumeration 시퀀스에서 현재 확장의 이름을 검색합니다.

반환된 확장 이름은 L"2.5.29.31"과 같이 OID( 개체 식별자 ) 문자열입니다.

구문

HRESULT GetName(
  [out] BSTR *pstrOut
);

매개 변수

[out] pstrOut

확장 이름을 포함하는 BSTR 형식의 값에 대한 포인터입니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환하고 pstrOut 매개 변수를 확장 이름으로 설정합니다.

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

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

VB

반환 값은 확장 이름을 포함하는 String 입니다.

설명

이 함수는 확장 열거형 시퀀스에서 현재 참조하는 확장의 이름을 검색하는 데 사용됩니다.

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

IEnumCERTVIEWEXTENSION::Reset: 열거형 시퀀스의 다음 확장으로 이동합니다.
IEnumCERTVIEWEXTENSION::Next: 열거형 시퀀스의 다음 확장으로 이동합니다.
IEnumCERTVIEWEXTENSION::Skip: 지정된 수의 확장을 건너뜁니다.

예제

BSTR  bstrExtName = NULL;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
    printf("Extension name is: %ws\n", bstrExtName);
else
    printf("GetName failed: %x\n", hr);

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

요구 사항

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