Freigeben über

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

  • Artikel

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