NAME

CSSM_CSP_ChangeLoginPassword

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_CSP_ChangeLoginPassword
    (CSSM_CSP_HANDLE CSPHandle,
    const CSSM_CRYPTO_DATA_PTR OldPassword,
    const CSSM_CRYPTO_DATA_PTR NewPassword)

DESCRIPTION

Changes the login password of the current login session from the old password to the new password. The requesting user must have a login session in process.

PARAMETERS

CSPHandle (input)

Handle of the CSP supporting the current login session.

OldPassword (input)

Current password used to log into the token.

NewPassword (input)

New password to be used for future logins by this user to this token.

RETURN VALUE

CSSM_OK if login is successful, CSSM_FAIL is login fails. Use CSSM_GetError to determine the exact error.

ERRORS

CSSM__CSP_INVALID_CSP_HANDLE

Invalid CSP handle.

CSSM__CSP_MEMORY_ERROR

Not enough memory to allocate.

CSSM__CSP_INVALID_PASSWORD

Old password is invalid.

SEE ALSO

CSSM_CSP_Login, CSSM_CSP_Logout