IEnumCERTVIEWATTRIBUTE::Skip 메서드(certview.h)
Skip 메서드는 특성 열거형 시퀀스에서 지정된 수의 특성을 건너뜁니다.
구문
HRESULT Skip(
[in] LONG celt
);
매개 변수
[in] celt
건너뛸 특성 수입니다. celt 매개 변수에 대한 양수 값을 사용하면 특성 열거형 시퀀스가 시퀀스에서 앞으로 건너뜁니다. celt 매개 변수에 대한 음수 값을 사용하면 특성 열거형 시퀀스가 시퀀스에서 뒤로 건너뜁니다.
반환 값
VB
메서드가 성공하면 메서드는 S_OK 반환합니다.E_INVALIDARG 반환 값은 celt 매개 변수의 음수 값으로 인해 특성 열거형 시퀀스 인덱스가 0보다 작게 되었음을 나타냅니다.
메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
설명
이 메서드가 성공적으로 완료되면 IEnumCERTVIEWATTRIBUTE::Next 메서드를 호출하여 특성 열거형 시퀀스에서 현재 특성을 참조합니다. 특성 이름 및 값은 다음 메서드를 통해 액세스할 수 있습니다.
특성 열거형 시퀀스는 내부 0부터 시작하는 인덱스를 유지 관리합니다. Skip 메서드를 호출하면 이 인덱스가 celt 매개 변수에 지정된 특성 수만큼 증가하거나 감소합니다.celt 매개 변수의 음수 값으로 인해 인덱스가 0보다 작으면 IEnumCERTVIEWATTRIBUTE::Next에 대한 후속 호출의 동작이 정의되지 않습니다.
celt 매개 변수의 양수 값으로 인해 인덱스가 열거형 시퀀스의 마지막 특성을 초과하면 IEnumCERTVIEWATTRIBUTE::Next 메서드에 대한 후속 호출이 실패합니다.
예제
HRESULT hr;
LONG Index;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip(5);
if (S_OK == hr)
{
// get the next attribute
hr = pEnumAttr->Next(&Index);
if (S_OK == hr)
{
// Use this attribute as needed.
}
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certview.h(Certsrv.h 포함) |
| 라이브러리 | Certidl.lib |
| DLL | Certadm.dll |