Metodo IX509ExtensionTemplate::InitializeEncode (certenroll.h)

  • Articolo

Il metodo InitializeEncode inizializza l'estensione da un identificatore di oggetto modello (OID) e da numeri di versione principali e secondari. Questo metodo è abilitato per Il Web.

Sintassi

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

Parametri

[in] pTemplateOid

Puntatore a un'interfaccia IObjectId che rappresenta l'OID del modello.

[in] MajorVersion

Variabile LONG contenente il numero di versione principale del modello. Il valore predefinito è zero (0).

[in] MinorVersion

Variabile LONG contenente il numero di versione secondaria del modello. Il valore predefinito è zero (0).

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 L'oggetto è già inizializzato.

Commenti

È necessario chiamare InitializeEncode o InitializeDecode prima di poter usare un oggetto IX509ExtensionTemplate. I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire un oggetto di estensione astratta (ASN.1) codificato Distinguished Encoding Rules (DER) e il metodo InitializeDecode consente di inizializzare i dati non elaborati da un oggetto codificato.

È possibile recuperare le proprietà seguenti per questa estensione:

È necessario chiamare InitializeEncode o InitializeDecode prima di poter usare un oggetto IX509ExtensionBasicConstraints. I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire una struttura ASN.1 codificata da dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da una struttura ASN.1 codificata. È possibile recuperare i dati non elaborati per l'estensione chiamando le proprietà MajorVersion, MinorVersion e TemplateOid.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certenroll.h
DLL CertEnroll.dll

Vedi anche

IX509ExtensionTemplate