IEnumCERTVIEWROW::EnumCertViewAttribute 메서드(certview.h)
EnumCertViewAttribute 메서드는 행 열거형 시퀀스의 현재 행에 대한 특성 열거형 시퀀스의 instance 가져옵니다.
구문
HRESULT EnumCertViewAttribute(
[in] LONG Flags,
[out] IEnumCERTVIEWATTRIBUTE **ppenum
);
매개 변수
[in] Flags
| C++ | LONG 값입니다. 0이어야 합니다. |
| VB | Long 값입니다. 0이어야 합니다. |
[out] ppenum
IEnumCERTVIEWATTRIBUTE 형식의 포인터에 대한 포인터입니다. 이 메서드가 성공적으로 완료되면 ppenum 이 IEnumCERTVIEWATTRIBUTE 형식의 포인터로 설정됩니다.
반환 값
C++
메서드가 성공하면 메서드는 S_OK 반환합니다.메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
VB
반환된 값은 특성 열거형 시퀀스 개체입니다.설명
이 호출에서 가져온 특성 열거형 시퀀스를 사용하여 현재 행의 인증서와 연결된 특성을 열거할 수 있습니다. 이 열거형은 IEnumCERTVIEWATTRIBUTE 인터페이스의 메서드를 통해 액세스할 수 있습니다.
다른 행을 참조하려면 다음 메서드 중 하나를 호출하여 행 열거형 시퀀스를 탐색합니다.
- IEnumCERTVIEWROW::Reset: 열거형 시퀀스의 시작 부분으로 이동합니다.
- IEnumCERTVIEWROW::Next: 열거형 시퀀스의 다음 행으로 이동합니다.
- IEnumCERTVIEWROW::Skip: 지정된 수의 행을 건너뜁니다.
예제
// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT hr;
LONG Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;
// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
printf("Failed EnumCertViewAttribute - %x\n", hr);
goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
// Use this attribute as needed.
}
error:
// Free resources.
if (NULL != pEnumAttr)
pEnumAttr->Release();
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certview.h(Certsrv.h 포함) |
| 라이브러리 | Certidl.lib |
| DLL | Certadm.dll |