Partager via


Utilities.GetRandom, méthode

[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