This function gets the Random Identifier set in the PcID retrieved by PK3NextQueryPcID. This function works for passwords that have an expiration date.

[C++Builder/Visual C++] BOOL PK3NextQueryRandom(LPSTR lpszRandom, LPLONG lpRandomLen);
[Delphi] function PK3NextQueryRandom(lpszRandom: PAnsiChar; var lpRandomLen: Longint): LongBool;
[Visual Basic] Function PK3NextQueryRandom(ByVal lpszRandom As String, lpRandomLen As Long) As Long

Parameters

Name Explanation
lpszRandom The retreived Random Identifier (length is 10 digits)
In C++Builder, Visual C++, and Delphi. this is a string of 10 digits followed by a terminating Null. In Visual Basic, this is a string of 10 digits.
lpRandomLen The number of digits in the retrieved Random Identifier

Return Value

Returns the True (nonzero) if successful, otherwise returns False (0).

Explanation

The PK3NextQueryRandom function gets the Random Identifier set in the PcID retrieved by PK3NextQueryPcID.

The PK3NextQueryRandom function is disabled when the password has no expiration or if the PK3Initialize function has not been executed.