CredUpdate

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

CRED
Credential Manager Functions