Metodo IX500DistinguishedName::Encode (certenroll.h)
Il metodo Encode inizializza l'oggetto da una stringa contenente un nome distinto. Questo metodo è abilitato per Il Web.
Sintassi
HRESULT Encode(
[in] BSTR strName,
[in] X500NameFlags NameFlags
);
Parametri
[in] strName
Variabile BSTR contenente la stringa da codificare.
[in] NameFlags
Valore di enumerazione X500NameFlags che specifica il formato del valore codificato.
- Il valore predefinito specificato in Certenroll.h è XCN_CERT_NAME_STR_NONE.
- Se non si specifica XCN_CERT_NAME_STR_FORWARD_FLAG, XCN_CERT_NAME_STR_REVERSE_FLAG viene applicato automaticamente.
- Se non si specifica XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG, XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG viene applicato automaticamente.
- XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG viene impostato automaticamente indipendentemente da qualsiasi altro flag specificato.
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 |
|---|---|
|
Impossibile allocare memoria per il valore codificato. |
|
Il parametro strName non può essere NULL. |
|
La lunghezza, in caratteri del parametro strName non può superare 64 * 1024. |
Commenti
Questo metodo chiama internamente la funzione CryptoAPI CertStrToName . Chiamare la proprietà Name per recuperare il nome come stringa di caratteri con terminazione null. Chiamare la proprietà EncodedName per recuperare una stringa contenente un nome codificato.
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 |