Metodo IPolicyQualifier::InitializeEncode (certenroll.h)
Il metodo InitializeEncode inizializza l'oggetto da una stringa e un valore che identifica il tipo di qualificatore.
Sintassi
HRESULT InitializeEncode(
[in] BSTR strQualifier,
[in] PolicyQualifierType Type
);
Parametri
[in] strQualifier
Variabile BSTR che contiene il qualificatore.
[in] Type
Valore di enumerazione PolicyQualifierType che specifica il tipo di qualificatore applicato a un criterio di certificato. Può trattarsi di uno dei valori seguenti.
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 dei codici di errore comuni, vedere Valori HRESULT comuni.
Codice restituito | Descrizione |
---|---|
|
L'oggetto è già inizializzato. |
Commenti
Se si specifica PolicyQualifierTypeUrl nel parametro Type, questo metodo associa la stringa immessa nel parametro strQualifier al XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) dell'identificatore di oggetto (OID) e lo codifica usando Distinguished Encoding Rules (DER). L'URL viene codificato come stringa IA5 astratta Notation One (ASN.1).
Se si specifica PolicyQualifierTypeUserNotice nel parametro Type , questo metodo associa la stringa immessa nel parametro strQualifier alla XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) e la codifica tramite DER.
È possibile recuperare le proprietà seguenti per questo oggetto:
- La proprietà ObjectId recupera un OID che identifica se il qualificatore è un CPS o un avviso utente.
- La proprietà Qualifier recupera la stringa specificata per il parametro strQualifier del metodo InitializeEncode .
- La proprietà RawData recupera il qualificatore con codifica DER.
- La proprietà Type recupera un valore dell'enumerazione PolicyQualifierType che specifica il tipo di qualificatore.
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 |