Metodo IX509AttributeRenewalCertificate::InitializeEncode (certenroll.h)

  • Articolo

Il metodo InitializeEncode inizializza l'attributo usando il certificato da rinnovare. Il certificato deve essere codificato usando Distinguished Encoding Rules (DER).

Sintassi

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strCert
);

Parametri

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato al certificato contenuto nel parametro strCert .

[in] strCert

Variabile BSTR contenente il certificato con codifica DER.

A partire da Windows 7 e Windows Server 2008 R2, è possibile specificare una stampa personale del certificato o un numero di serie anziché un certificato codificato. In questo modo, la funzione cerca gli archivi locali appropriati per il certificato corrispondente. Tenere presente quanto segue:

  • BSTR deve essere un numero pari di cifre esadecimali.
  • Lo spazio vuoto tra coppie esadecimali viene ignorato.
  • Il parametro Codifica deve essere impostato su XCN_CRYPT_STRING_HEXRAW.
  • Se è necessaria una chiave privata, vengono cercati solo gli archivi personali e delle richieste.
  • Se non è necessaria una chiave privata, vengono inoltre cercati gli archivi ca radice e intermedi.

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. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

L'identificatore dell'oggetto (OID) per questo attributo è XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1). Per altre informazioni, vedere CERTENROLL_OBJECTID.

È necessario chiamare InitializeEncode o InitializeDecode prima di poter usare un oggetto IX509AttributeRenewalCertificate. I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire una struttura astratta notazione astratta (ASN.1) codificata dai dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da una struttura ASN.1 codificata. È possibile chiamare la proprietà RenewalCertificate per recuperare i dati non elaborati.

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

IX509AttributeRenewalCertificate