Condividi tramite


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 Significato
PolicyQualifierTypeUnknown
Il tipo di qualificatore non è specificato.
PolicyQualifierTypeUrl
Il qualificatore è un URL che punta a un'istruzione cps (Certification Practice Statement) definita dall'autorità di certificazione per delineare i criteri con cui è stato rilasciato il certificato e gli scopi per cui è possibile usare il certificato.
PolicyQualifierTypeUserNotice
Il qualificatore è un'istruzione di testo da visualizzare dall'applicazione a qualsiasi utente che si basa sul certificato. L'avviso utente identifica gli usi consentiti del certificato.

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
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

Vedi anche

IPolicyQualifier