IX500DistinguishedName::Encode-Methode (certenroll.h)

Artikel
08/22/2023

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

Freigeben über