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

아티클
08/22/2023

GetName 메서드는 열 열거형 시퀀스에서 현재 열의 할당되지 않은 이름을 검색합니다.

구문

HRESULT GetName(
  [out] BSTR *pstrOut
);

매개 변수

[out] pstrOut

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

반환 값

C++

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

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

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

VB

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

설명

이 메서드는 열 열거형 시퀀스에서 현재 참조하는 열의 할당되지 않은 이름을 검색하는 데 사용됩니다.

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

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

예제

BSTR       bstrColName = NULL;
HRESULT    hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrColName);

// done processing, clear resources
if (NULL != bstrColName)
    SysFreeString(bstrColName);

요구 사항

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