IX500DistinguishedName::D ecode-Methode (certenroll.h)

2024-02-23

Die Decode-Methode initialisiert das Objekt aus einem Unicode-codierten distinguished Name.

Syntax

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

Parameter

[in] strEncodedName

Eine BSTR-Variable , die den codierten Namen enthält.

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die Eingabezeichenfolge angewendet wird. Der Standardwert ist XCN_CRYPT_STRING_BASE64.

[in] NameFlags

Ein X500NameFlags-Enumerationswert , der das Format der decodierten Zeichenfolge angibt.

Hinweis Die folgenden Flags werden automatisch festgelegt:

Der in Certenroll.h angegebene Standardwert ist XCN_CERT_NAME_STR_NONE.
Wenn Sie XCN_CERT_NAME_STR_FORWARD_FLAG nicht angeben, wird automatisch XCN_CERT_NAME_STR_REVERSE_FLAG angewendet.
Wenn Sie XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG nicht angeben, wird automatisch XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG angewendet.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG wird unabhängig von anderen von Ihnen angegebenen Flags automatisch festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert	BESCHREIBUNG
E_OUTOFMEMORY	Der Speicher konnte für den decodierten Wert nicht zugeordnet werden.
E_POINTER	Der strEncodedName-Parameter darf nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Der Name konnte nicht decodiert werden.

Hinweise

Diese Methode ruft intern die CryptoAPI CertNameToStr-Funktion auf. Rufen Sie die Name-Eigenschaft auf, um den Namen als null-endende Zeichenfolge abzurufen. Rufen Sie die EncodedName-Eigenschaft auf, um eine Zeichenfolge abzurufen, die einen codierten Namen enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

IX500DistinguishedName