IX509ExtensionTemplate::InitializeEncode 메서드(certenroll.h)

InitializeEncode 메서드는 OID(템플릿 개체 식별자) 및 주 버전 및 부 버전 번호에서 확장을 초기화합니다. 이 메서드는 웹을 사용할 수 있습니다.

구문

HRESULT InitializeEncode(
  [in] IObjectId *pTemplateOid,
  [in] LONG      MajorVersion,
  [in] LONG      MinorVersion
);

매개 변수

[in] pTemplateOid

템플릿 OID를 나타내는 IObjectId 인터페이스에 대한 포인터입니다.

[in] MajorVersion

템플릿의 주 버전 번호를 포함하는 LONG 변수입니다. 기본값은 영(0)입니다.

[in] MinorVersion

템플릿의 부 버전 번호를 포함하는 LONG 변수입니다. 기본값은 영(0)입니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

반환 코드/값	설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	개체가 이미 초기화되었습니다.

설명

IX509ExtensionTemplate 개체를 사용하려면 먼저 InitializeEncode 또는 InitializeDecode를 호출해야 합니다. 두 메서드는 서로를 보완합니다. InitializeEncode 메서드를 사용하면 원시 데이터에서 DER(Distinguished Encoding Rules)로 인코딩된 ASN.1(Abstract Syntax Notation One) 확장 개체를 생성할 수 있으며 InitializeDecode 메서드를 사용하면 인코딩된 개체에서 원시 데이터를 초기화할 수 있습니다.

이 확장에 대해 다음 속성을 검색할 수 있습니다.

• Critical 속성은 확장이 중요한지 여부를 식별합니다. 이 속성을 지정할 수도 있습니다.
• ObjectId 속성은 OID를 검색합니다.
• MajorVersion 및 MinorVersion 속성은 버전 정보를 검색합니다.
• TemplateOid 속성은 템플릿의 OID를 검색합니다.

IX509ExtensionBasicConstraints 개체를 사용하려면 먼저 InitializeEncode 또는 InitializeDecode를 호출해야 합니다. 두 메서드는 서로를 보완합니다. InitializeEncode 메서드를 사용하면 원시 데이터에서 인코딩된 ASN.1 구조를 생성할 수 있으며 InitializeDecode 메서드를 사용하면 인코딩된 ASN.1 구조체에서 원시 데이터를 초기화할 수 있습니다. MajorVersion, MinorVersion 및 TemplateOid 속성을 호출하여 확장에 대한 원시 데이터를 검색할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certenroll.h
DLL	CertEnroll.dll

추가 정보

IX509ExtensionTemplate