int WINAPI AceGetPinParams(
The AceGetPinParams function obtains all of the PIN-related parameters at once. It is
helpful to retrieve this value when the result code from AceCheck is
ACM_NEW_PIN_REQUIRED and the Agent is designed to validate that the new PIN
entered by the user conforms to the required PIN characteristics set by the RSA ACE/Server
administrator. Any such checking done by the Agent is simply as a convenience to the user.
The PIN will be fully checked for correctness by the RSA ACE/Server.
The caller of this synchronous function must supply, as the second argument, a pointer to a
structure of type SD_PIN, into which the function will copy the PIN parameters.
AceGetPinParams does not allocate storage for the data on its own.
SdiHandle The value of a handle originally assigned by a call to AceInit.
Val A pointer to a structure of type SD_PIN that will contain
copies of the PIN parameters.
Outputs and Post Conditions
The function returns ACE_SUCCESS if the handle to the authentication data was found and
the PIN value was provided by the function.
A value of ACE_ERR_INVALID_HANDLE is returned if the handle to the authentication
data cannot be found.