Metodo IX509ExtensionCertificatePolicies::InitializeEncode (certenroll.h)

  • Articolo

Il metodo InitializeEncode inizializza l'oggetto da un insieme ICertificatePolicies .

Sintassi

HRESULT InitializeEncode(
  [in] ICertificatePolicies *pValue
);

Parametri

[in] pValue

Puntatore all'interfaccia ICertificatePolicies .

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

Il metodo associa la raccolta dei nomi all'identificatore dell'oggetto (OID) XCN_OID_CERT_POLICIES (2.5.29.32) e lo codifica usando Distinguished Encoding Rules (DER).

È necessario chiamare InitializeEncode o InitializeDecode prima di poter usare un oggetto IX509ExtensionCertificatePolicies. I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire un oggetto di estensione ASN.1 con codifica DER per l'estensione Notation One (ASN.1) dai dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da un oggetto codificato. È possibile recuperare la raccolta di criteri (i dati non elaborati) chiamando la proprietà Policies .

È possibile recuperare le proprietà seguenti per questa estensione:

  • La proprietà Critical identifica se l'estensione è critica. È anche possibile specificare questa proprietà.
  • La proprietà ObjectId recupera l'OID dell'estensione.
  • La proprietà Policies recupera la raccolta di criteri di certificato (i dati dell'estensione non elaborati).

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
DLL CertEnroll.dll

Vedi anche

IX509ExtensionCertificatePolicies