Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der Speicher konnte für den codierten Wert nicht zugeordnet werden. |
|
Der strName-Parameter darf nicht NULL sein. |
|
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 |