Previous section.

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

NAME

CSP_ChangeLoginPassword

SYNOPSIS

CSSM_RETURN CSSMSPI 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.

CSSM_CSP_OPERATION_UNSUPPORTED

Change login password service not supported.

SEE ALSO

CSP_Login, 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