Freigeben über

IX500DistinguishedName::Encode-Methode (certenroll.h)

  • Artikel

Die Encode-Methode initialisiert das Objekt aus einer Zeichenfolge, die einen distinguished Name enthält. Diese Methode ist webfähig.

Syntax

HRESULT Encode(
  [in] BSTR          strName,
  [in] X500NameFlags NameFlags
);

Parameter

[in] strName

Eine BSTR-Variable , die die zu codierende Zeichenfolge enthält.

[in] NameFlags

Ein X500NameFlags-Enumerationswert , der das Format des codierten Werts 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 codierten Wert nicht zugeordnet werden.
E_POINTER
 Der strName-Parameter darf nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
 Die Länge in Zeichen des strName-Parameters darf 64 * 1024 nicht überschreiten.

Hinweise

Diese Methode ruft intern die CertStrToName-Funktion CryptoAPI 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

   
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