Utilities.GetRandom, méthode

Article
06/13/2023

[La méthode GetRandom est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise.]

La méthode GetRandom génère un nombre aléatoire sécurisé à l’aide du fournisseur de services de chiffrement (CSP) par défaut.

Syntaxe

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

Paramètres

Longueur [in, facultatif]

Longueur, en octets, du nombre aléatoire à créer. La valeur par défaut est 8 octets.

EncodingType [in, facultatif]

Valeur de l’énumération CAPICOM_ENCODING_TYPE qui indique le type d’encodage à utiliser pour le nombre aléatoire généré. La valeur par défaut est CAPICOM_ENCODE_BINARY. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_ENCODE_ANY	Ce type d’encodage est utilisé uniquement lorsque les données d’entrée ont un type d’encodage inconnu. Si cette valeur est utilisée pour spécifier le type d’encodage de la sortie, CAPICOM_ENCODE_BASE64 sera utilisé à la place. Introduit dans CAPICOM 2.0.
CAPICOM_ENCODE_BASE64	Les données sont enregistrées sous forme de chaîne encodée en base64.
CAPICOM_ENCODE_BINARY	Les données sont enregistrées en tant que séquence binaire pure.

Valeur retournée

Nombre d’octets de longueur de longueur généré aléatoirement, avec l’encodage spécifié.

Spécifications

Condition requise	Valeur
Composant redistribuable	CAPICOM 2.0 ou version ultérieure sur Windows Server 2003 et Windows XP
DLL	Capicom.dll

Voir aussi

Utilitaires