CryptBinaryToStringW-Funktion (wincrypt.h)
Die CryptBinaryToString-Funktion konvertiert ein Bytearray in eine formatierte Zeichenfolge.
Syntax
BOOL CryptBinaryToStringW(
[in] const BYTE *pbBinary,
[in] DWORD cbBinary,
[in] DWORD dwFlags,
[out, optional] LPWSTR pszString,
[in, out] DWORD *pcchString
);
Parameter
[in] pbBinary
Ein Zeiger auf das Array von Bytes, das in eine Zeichenfolge konvertiert werden soll.
[in] cbBinary
Die Anzahl der Elemente im pbBinary-Array .
[in] dwFlags
Gibt das Format der resultierenden formatierten Zeichenfolge an. Dieser Parameter kann einen der folgenden Werte annehmen.
Wert | Bedeutung |
---|---|
|
Base64 mit Anfangs- und Endheadern des Zertifikats. |
|
Base64, ohne Header. |
|
Reine binäre Kopie. |
|
Base64 mit Anfangs- und Endheadern der Anforderung. |
|
Nur hexadezimal. |
|
Hexadezimal, mit ASCII-Zeichenanzeige . |
|
Base64 mit X.509-CRL-Anfangs - und Endheadern. |
|
Hexadezimal, mit Adressanzeige. |
|
Hexadezimal, mit ASCII-Zeichen und Adressanzeige. |
|
Eine unformatierte Hexadezimalzeichenfolge.
Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt. |
|
Erzwingen Sie die strikte Decodierung von ASN.1-Textformaten. Einige ASN.1-Binärblobs können die ersten Bytes des BLOB fälschlicherweise als Base64-Text interpretiert haben. In diesem Fall wird der rest des Texts ignoriert. Verwenden Sie dieses Flag, um die vollständige Decodierung des BLOB zu erzwingen.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt. |
Zusätzlich zu den oben genannten Werten kann einer oder mehrere der folgenden Werte angegeben werden, um das Verhalten der Funktion zu ändern.
[out, optional] pszString
Ein Zeiger auf einen Puffer, der die konvertierte Zeichenfolge empfängt. Um die Anzahl der Zeichen zu berechnen, die zugeordnet werden müssen, um die zurückgegebene Zeichenfolge zu speichern, legen Sie diesen Parameter auf NULL fest. Die Funktion platziert die erforderliche Anzahl von Zeichen, einschließlich des abschließenden NULL-Zeichens , in den Wert, auf den pcchString verweist.
[in, out] pcchString
Ein Zeiger auf eine DWORD-Variable, die die Größe des pszString-Puffers in TCHARs enthält. Wenn pszStringNULL ist, berechnet die Funktion die Länge der Rückgabezeichenfolge (einschließlich des abschließenden NULL-Zeichens) in TCHARs und gibt sie in diesem Parameter zurück. Wenn pszString nicht NULL und groß genug ist, konvertiert die Funktion die Binärdaten in ein angegebenes Zeichenfolgenformat, einschließlich des abschließenden NULL-Zeichens, aber pcchString empfängt die Länge in TCHARs, ohne das abschließende NULL-Zeichen.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null (TRUE) zurück.
Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück.
Hinweise
Mit Ausnahme von, wenn CRYPT_STRING_BINARY Codierung verwendet wird, werden alle Zeichenfolgen mit einer neuen Zeilensequenz angefügt. Standardmäßig ist die neue Zeilensequenz ein CR/LF-Paar (0x0D/0x0A). Wenn der dwFlags-Parameter das flag CRYPT_STRING_NOCR enthält, ist die neue Zeilensequenz ein LF-Zeichen (0x0A). Wenn der dwFlags-Parameter das flag CRYPT_STRING_NOCRLF enthält, wird keine neue Zeilensequenz an die Zeichenfolge angefügt.
Hinweis
Der wincrypt.h-Header definiert CryptBinaryToString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | wincrypt.h |
Bibliothek | Crypt32.lib |
DLL | Crypt32.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für