Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The CredUpdatefunction 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, wszUsercannot be NULL.

For more information about the credential structure used, please see the CREDstructure.

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

See Also