IOpcCertificateEnumerator::GetCurrent 메서드(msopc.h)

아티클
11/11/2023

열거자의 현재 위치에 있는 CERT_CONTEXT 구조를 가져옵니다.

구문

HRESULT GetCurrent(
  [out, retval] const CERT_CONTEXT **certificate
);

매개 변수

[out, retval] certificate

CERT_CONTEXT 구조체에 대한 포인터입니다. 메서드가 성공하면 CertFreeCertificateContext 함수를 호출하여 구조체의 메모리를 해제합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드/값	Description
S_OK	메서드가 성공했습니다.
E_POINTER	partReference 매개 변수는 NULL입니다.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	기본 집합이 변경되었으므로 열거자가 잘못되었습니다.
OPC_E_ENUM_INVALID_POSITION 0x80510053	열거자는 현재 위치에서 이 작업을 수행할 수 없습니다.
OPC_E_DS_EXTERNAL_SIGNATURE 0x8051001E	대상이 서명 부분인 관계에는 외부 대상 모드가 있습니다. 서명 부분은 패키지 내에 있어야 합니다.
OPC_E_DS_INVALID_CERTIFICATE_RELATIONSHIP 0x8051001D	디지털 서명 인증서 유형의 관계에는 외부 대상 모드가 있습니다. 이 관계 유형에 대한 자세한 내용은 OPC를 참조하세요.
OPC_E_DS_INVALID_RELATIONSHIP_TRANSFORM_XML 0x80510021	관계 변환의 사용과 변환에 대한 선택 조건이 OPC에 지정된 스키마를 준수하지 않음을 나타내는 Transform 요소입니다.
OPC_E_DS_MISSING_CERTIFICATE_PART 0x80510056	인증서를 포함하고 디지털 서명 인증서 형식의 관계의 대상인 파트가 없습니다. 이 관계 유형에 대한 자세한 내용은 OPC를 참조하세요.
OPC_E_DS_SIGNATURE_PROPERTY_MISSING_TARGET 0x80510045	SignatureProperty 요소에 필요한 Target 특성이 없습니다.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	파트의 콘텐츠 형식이 예상 콘텐츠 형식(OPC, ECMA-376 파트 2에 지정됨)와 다르거나 파트 콘텐츠가 파트의 콘텐츠 형식과 일치하지 않습니다.

설명

CERT_CONTEXT 구조로 표시되는 인증서가 손상되었거나 X.509 인증서가 아닌 경우 이 메서드는 오류를 반환합니다. 또한 호출자가 사용하는 서명 정책은 서명의 유효성을 검사할지 여부를 결정합니다. 이러한 종류의 오류가 반환된 후 MoveNext 또는 MovePrevious 메서드에 대한 호출은 열거자를 통해 계속 반복됩니다.

열거자를 만들 때 현재 위치는 열거자의 첫 번째 포인터 앞에 옵니다. 현재 위치를 첫 번째 포인터로 설정하려면 열거자를 만든 후 MoveNext 메서드를 호출합니다.

스레드 보안

개체 패키징은 스레드로부터 안전하지 않습니다.

자세한 내용은 패키징 API를 사용한 시작 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	msopc.h