Share via


CredUpdate (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

Credential Manager Functions
CRED