CryptStringToBinaryA-Funktion (wincrypt.h)

Die CryptStringToBinary-Funktion konvertiert eine formatierte Zeichenfolge in ein Array von Bytes.

Syntax

BOOL CryptStringToBinaryA(
  [in]      LPCSTR pszString,
  [in]      DWORD  cchString,
  [in]      DWORD  dwFlags,
  [in]      BYTE   *pbBinary,
  [in, out] DWORD  *pcbBinary,
  [out]     DWORD  *pdwSkip,
  [out]     DWORD  *pdwFlags
);

Parameter

[in] pszString

Ein Zeiger auf eine Zeichenfolge, die die formatierte Zeichenfolge enthält, die konvertiert werden soll.

[in] cchString

Die Anzahl der Zeichen der formatierten Zeichenfolge, die konvertiert werden soll, ohne das beendende NULL-Zeichen . Wenn dieser Parameter 0 ist, wird pszString als null-beendete Zeichenfolge betrachtet.

[in] dwFlags

Gibt das Format der zu konvertierenden Zeichenfolge an. Dies kann einer der folgenden Werte sein.

[in] pbBinary

Ein Zeiger auf einen Puffer, der die zurückgegebene Bytesequenz empfängt. Wenn dieser Parameter NULL ist, berechnet die Funktion die Länge des benötigten Puffers und gibt die Größe des erforderlichen Arbeitsspeichers in der DWORD zurück, auf die pcbBinary verweist.

[in, out] pcbBinary

Ein Zeiger auf eine DWORD-Variable , die beim Eintrag die Größe des pbBinary-Puffers in Bytes enthält. Nachdem die Funktion zurückgegeben wurde, enthält diese Variable die Anzahl der Bytes, die in den Puffer kopiert wurden. Wenn dieser Wert nicht groß genug ist, um alle Daten zu enthalten, schlägt die Funktion fehl, und GetLastError gibt ERROR_MORE_DATA zurück.

Wenn pbBinaryNULL ist, wird das DWORD ignoriert, auf das von pcbBinary verwiesen wird.

[out] pdwSkip

Ein Zeiger auf einen DWORD-Wert , der die Anzahl der Zeichen empfängt, die übersprungen werden, um den Anfang des -----BEGIN ...----- Headers zu erreichen. Wenn kein Header vorhanden ist, wird der DWORD-Wert auf 0 festgelegt. Dieser Parameter ist optional und kann NULL sein, wenn er nicht benötigt wird.

[out] pdwFlags

Ein Zeiger auf einen DWORD-Wert , der die flags empfängt, die tatsächlich bei der Konvertierung verwendet werden. Dies sind dieselben Flags, die für den dwFlags-Parameter verwendet werden. In vielen Fällen sind dies dieselben Flags, die im dwFlags-Parameter übergeben wurden. Wenn dwFlags eines der folgenden Flags enthält, erhält dieser Wert ein Flag, das das tatsächliche Format der Zeichenfolge angibt. Dieser Parameter ist optional und kann NULL sein, wenn er nicht benötigt wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null (TRUE).

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (FALSE).

Hinweise

Die Flags CRYPT_STRING_BASE64HEADER, CRYPT_STRING_BASE64REQUESTHEADER und CRYPT_STRING_BASE64X509CRLHEADER werden von dieser Funktion identisch behandelt: Sie versuchen, den ersten Block von base64-codierten Daten zwischen Zeilen des Formulars -----BEGIN ...----- und -----END ...-----zu analysieren. Die ... Teile werden ignoriert und müssen nicht übereinstimmen. Wenn die Analyse erfolgreich ist, wird der im dwFlags-Parameter übergebene Wert im DWORD zurückgegeben, auf das der parameter pdwFlags verweist. Beachten Sie, dass der Wert CRYPT_STRING_BASE64REQUESTHEADER oder CRYPT_STRING_BASE64X509CRLHEADER nicht bedeutet, dass ein Anforderungsheader oder eine X.509-Zertifikatsperrliste (CertificateRevocation List , CRL) gefunden wurde.

Anforderungen

Weitere Informationen

CryptBinaryToString