Freigeben über


Utilities.GetRandom-Methode

[Die GetRandom-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind.]

Die GetRandom-Methode generiert mithilfe des Standardmäßigen Kryptografiedienstanbieters (CSP) eine sichere Zufallszahl.

Syntax

Utilities.GetRandom( _
  [ ByVal Length ], _
  [ ByVal EncodingType ] _
)

Parameter

Länge [in, optional]

Die Länge der zu erstellenden Zufallszahl in Bytes. Der Standardwert ist 8 Bytes.

EncodingType [in, optional]

Ein Wert der CAPICOM_ENCODING_TYPE Enumeration, der den Typ der Codierung angibt, die für die generierte Zufallszahl verwendet werden soll. Der Standardwert ist CAPICOM_ENCODE_BINARY. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
CAPICOM_ENCODE_ANY
Dieser Codierungstyp wird nur verwendet, wenn die Eingabedaten einen unbekannten Codierungstyp aufweisen. Wenn dieser Wert verwendet wird, um den Codierungstyp der Ausgabe anzugeben, wird stattdessen CAPICOM_ENCODE_BASE64 verwendet. In CAPICOM 2.0 eingeführt.
CAPICOM_ENCODE_BASE64
Daten werden als base64-codierte Zeichenfolge gespeichert.
CAPICOM_ENCODE_BINARY
Daten werden als reine Binärsequenz gespeichert.

 

Rückgabewert

Eine zufällig generierte Anzahl Längenbyte lang mit der angegebenen Codierung.

Anforderungen

Anforderung Wert
Verteilbare Komponente
CAPICOM 2.0 oder höher unter Windows Server 2003 und Windows XP
DLL
Capicom.dll

Siehe auch

Hilfsprogramme