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