Interfaccia IX509ExtensionTemplate (certenroll.h)

L'interfaccia IX509ExtensionTemplate definisce metodi e proprietà che possono essere usati per inizializzare o recuperare un'estensione CertificateTemplate . Questa estensione può essere inserita nella richiesta di certificato per indicare all'autorità di certificazione quale modello usare durante il rilascio o il rinnovo di un certificato.

Nota L'estensione CertificateTemplate viene usata per identificare i modelli della versione 2. Per identificare un modello versione 1, è possibile usare l'estensione CertificateTemplateName definita dall'interfaccia IX509ExtensionTemplateName .

 

La sintassi seguente mostra la struttura ASN.1 ( Abstract Syntax Notation One ) dell'estensione. Il valore dell'estensione viene codificato usando Distinguished Encoding Rules (DER) e incluso nella richiesta di certificato.

----------------------------------------------------------------------
-- CertificateTemplate
-- XCN_OID_CERTIFICATE_TEMPLATE (1.3.6.1.4.1.311.21.7)
----------------------------------------------------------------------

CertificateTemplate ::= SEQUENCE 
{
   templateID              EncodedObjectID,
   templateMajorVersion    TemplateVersion,
   templateMinorVersion    TemplateVersion OPTIONAL
}

TemplateVersion ::= INTEGER (0..4294967295)

Per aggiungere questo oggetto di estensione a una richiesta PKCS #10 o a una richiesta CMC, è innanzitutto necessario aggiungerlo a un insieme IX509Extensions e usare l'insieme per inizializzare un oggetto IX509AttributeExtensions . Per altre informazioni, vedere gli argomenti PKCS #10 Extensions (Estensioni PKCS #10 ) e CMC Extensions (Estensioni CMC ).

Ereditarietà

L'interfaccia IX509ExtensionTemplate eredita da IX509Extension. IX509ExtensionTemplate include anche questi tipi di membri:

Metodi

L'interfaccia IX509ExtensionTemplate include questi metodi.

IX509ExtensionTemplate::get_MajorVersion Recupera il numero di versione principale minimo del modello di certificato.
IX509ExtensionTemplate::get_MinorVersion Recupera il numero di versione secondario minimo del modello di certificato.
IX509ExtensionTemplate::get_TemplateOid Recupera l'identificatore dell'oggetto modello (OID).
IX509ExtensionTemplate::InitializeDecode Inizializza l'estensione da una matrice di byte con codifica DER che contiene il valore dell'estensione.
IX509ExtensionTemplate::InitializeEncode Inizializza l'estensione da un OID (Template Object Identifier) e dai numeri di versione principale e secondaria.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h

Vedi anche

Interfacce CertEnroll

IX509Extension