Metodo IX509ExtensionCertificatePolicies::InitializeEncode (certenroll.h)
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 |
---|---|
|
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 |