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

아티클
02/26/2024

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

구문

HRESULT Skip(
  [in] LONG celt
);

매개 변수

[in] celt

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

반환 값

VB

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

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

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

설명

이 함수가 성공적으로 완료되면 IEnumCERTVIEWCOLUMN::Next 메서드를 호출하여 열 열거형 시퀀스의 현재 열을 참조합니다. 이 두 번째 호출이 수행된 후 다음 메서드 중 하나를 호출하여 열의 정보를 가져올 수 있습니다.

IEnumCERTVIEWCOLUMN::GetName: 열의 로컬화되지 않은 이름을 검색합니다.
IEnumCERTVIEWCOLUMN::GetDisplayName: 열의 지역화된 이름을 검색합니다.
IEnumCERTVIEWCOLUMN::GetValue: 열의 데이터를 검색합니다.
IEnumCERTVIEWCOLUMN::GetType: 열의 데이터 형식을 검색합니다.
IEnumCERTVIEWCOLUMN::GetMaxLength: 열의 최대 길이(바이트)를 검색합니다.

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

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

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

예제

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column as needed.
    }
}

요구 사항

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