RNG_HexWithPrompt

Generates a random set of data in hexadecimal format suitable for cryptographic keys with a prompt for the user to enter random keystrokes and mouse movements.

VB6/VBA Syntax

nRet = RNG_HexWithPrompt(strOutput, nMaxChars, strPrompt, nOptions)

Parameters

strOutput

[out] String of sufficient length to receive the output.

nMaxChars

[in] Long specifying the maximum number of characters in strOutput.

strPrompt

[in] String specifying an (optional) prompt for the dialog. Specify an empty string ("") or NULL to use the default dialog.

nOptions

[in] Long option flags:
API_DEFAULT (0) for default options
API_RNG_STRENGTH_112 to make user generate an estimated 112 bits of security (default)
API_RNG_STRENGTH_128 to make user generate an estimated 128 bits of security

C/C++ Syntax

Returns (VB6/C)

Long: If successful, the return value is 0. If the parameters are invalid, it returns a negative error code.

.NET Equivalent

Rng.HexWithPrompt Method (Int32)
Rng.HexWithPrompt Method (Int32, String, Rng.Strength)

Remarks

See the remarks for RNG_BytesWithPrompt.

Example

Dim strHexData As String
Dim nBytes As Long

' Allocate output string for 16 bytes = 2 x the number of bytes
nBytes = 16
strHexData = String(nBytes * 2, " ")

' Default prompt with default 112-bit security strength
Call RNG_HexWithPrompt(strHexData, Len(strHexData), nBytes, "", 0)
Debug.Print strHexData

' User-selected prompt with 128-bit security strength
Call RNG_HexWithPrompt(strHexData, Len(strHexData), nBytes, "Our own prompt: type until done...", API_RNG_STRENGTH_128)
Debug.Print strHexData

See Also

RNG_KeyHex

[Contents] [Index]