Metodo IX500DistinguishedName::D ecode (certenroll.h)

Articolo
02/23/2024

Il metodo Decode inizializza l'oggetto da un nome distinto con codifica Unicode.

Sintassi

HRESULT Decode(
  [in] BSTR          strEncodedName,
  [in] EncodingType  Encoding,
  [in] X500NameFlags NameFlags
);

Parametri

[in] strEncodedName

Variabile BSTR contenente il nome codificato.

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato alla stringa di input. Il valore predefinito è XCN_CRYPT_STRING_BASE64.

[in] NameFlags

Valore di enumerazione X500NameFlags che specifica il formato della stringa decodificata.

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 decodificato.
E_POINTER	Il parametro strEncodedName non può essere NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Impossibile decodificare il nome.

Commenti

Questo metodo chiama internamente la funzione CryptoAPI CertNameToStr . 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

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

IX500DistinguishedName

Condividi tramite