Previous section.

Common Security: CDSA and CSSM
Copyright © 1997 The Open Group

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

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.
You should also read the legal notice explaining the terms and conditions relating to the CDSA documentation.

Contents Next section Index