Metodo IX500DistinguishedName::Encode (certenroll.h)

  • Articolo

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.

Nota I flag seguenti vengono impostati automaticamente:
  • 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
E_OUTOFMEMORY
 Impossibile allocare memoria per il valore codificato.
E_POINTER
 Il parametro strName non può essere NULL.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
 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

Vedi anche

IX500DistinguishedName