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

아티클
08/22/2023

Skip 메서드는 확장 열거형 시퀀스에서 지정된 수의 확장을 건너뜁니다.

구문

HRESULT Skip(
  [in] LONG celt
);

매개 변수

[in] celt

건너뛸 확장 수입니다. celt 매개 변수에 대한 양수 값을 사용하면 확장 열거형 시퀀스가 시퀀스에서 앞으로 건너뜁니다. celt 매개 변수에 대한 음수 값을 사용하면 확장 열거형 시퀀스가 시퀀스에서 뒤로 건너뜁니다.

반환 값

VB

메서드가 성공하면 메서드는 S_OK 반환합니다.

E_INVALIDARG 반환 값은 celt 매개 변수의 음수 값으로 인해 확장 열거형 시퀀스 인덱스가 0보다 작게 되었음을 나타냅니다.

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

설명

이 메서드가 성공적으로 완료되면 IEnumCERTVIEWEXTENSION::Next 메서드를 호출하여 확장 열거형 시퀀스의 현재 확장을 참조합니다. 확장 이름, 플래그 및 값은 다음 메서드를 통해 액세스할 수 있습니다.

확장 열거형 시퀀스는 내부 0부터 시작하는 인덱스를 유지 관리합니다. Skip 메서드를 호출하면 이 인덱스가 celt 매개 변수에 지정된 확장 수만큼 증가하거나 감소합니다.

celt 매개 변수의 음수 값으로 인해 인덱스가 0보다 작으면 IEnumCERTVIEWEXTENSION::Next에 대한 후속 호출의 동작이 정의되지 않습니다.

celt 매개 변수의 양수 값으로 인해 인덱스가 열거형 시퀀스의 마지막 확장을 초과하면 IEnumCERTVIEWEXTENSION::Next 메서드에 대한 후속 호출이 실패합니다.

예제

HRESULT  hr;
LONG     Index;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
// skip the next 5 extensions
hr = pEnumExt->Skip(5);
if (S_OK == hr)
{
    // get the next extension
    hr = pEnumExt->Next(&Index);
    if (S_OK == hr)
    {
        // Use this extension as needed.
    }
}

요구 사항

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