CredUpdate
A version of this page is also available for
4/8/2010
The CredUpdate function updates the credential that is uniquely identified by the tuple that contains the credential type and the target ID associated with the credential.
Syntax
DWORD CredUpdate(
WSTR wszTarget,
DWORD dwTargetLen,
DWORD dwType,
PCRED pCred,
DWORD dwFlags
);
Parameters
- wszTarget
[in] Target to search for. Must be null-terminated, and cannot be NULL.
- dwTargetLen
[in] Number of characters in the target string, including the null-terminator. Cannot exceed CRED_MAX_TARGET_LEN.
dwType
[in] Type of credential to search for. The following table shows the pre-defined credential types.Credential type Description CRED_TYPE_NTLM
Credential type used for NTLM.
CRED_TYPE_KERBEROS
Credential type used for Kerberos.
CRED_TYPE_DOMAIN_PASSWORD
Credential type used for domain authentication.
CRED_TYPE_CERTIFICATE
Credential is a certificate.
CRED_TYPE_PLAINTEXT_PASSWORD
Credential is a plain password.
CRED_TYPE_GENERIC
Credential is stored as an opaque blob, but has no identifying characteristics.
pCred
[in] Pointer to credential that has to be updated. If updating the user information, wszUser cannot be NULL.For more information about the credential structure used, please see the CRED structure.
dwFlags
[in] Bitmask of flags. The following table shows the optional flags.Credential type Description CRED_FLAG_PERSIST
Credential will be persisted in the registry. If this flag is not set, the credential will be stored in memory and will not exist after a soft reset.
CRED_FLAG_DEFAULT
Marks the credential as default for this type. If any credential is requested and Credential Manager is unable to find it, this default credential will be returned.
CRED_FLAG_SENSITIVE
User must authenticate to the device in order to access this credential.
CRED_FLAG_TRUSTED
Credential can only be read by trusted components.
Return Value
ERROR_SUCCESS is returned upon success. For a list of error codes, see Credential Manager Error Codes.
Requirements
| Header | cred.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |