CredentialsDialogOptions Enumeration

Definition

Namespace: DevCase.Win32.Enums
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[FlagsAttribute]
public enum CredentialsDialogOptions

Remarks

Members

None 0 None.
IncorrectPassword 1 Silently ignore this flag.
DoNotPersist 2 Do not display the save message or store credentials. ShowSaveCheckBox can also be passed to display the save message only and return the result In refSave parameter.
RequestAdministrator 4 Silently ignore this flag.
ExcludeCertificates 8 Prompt for user name/password.

If the pszUserName parameter is specified, the user name is omitted.

If the credential is persisted, store the passed-in user name with the credential.

RequireCertificate 16 Reserved for future use; do not pass this flag.
ShowSaveCheckBox 64 Display the save message and return Tre in the refSave parameter if the user answers "y" (Yes), if the user answers "n" (No).

DoNotPersist must be specified to use this flag.

AlwaysShowUI 128 Display a user interface if the credentials can be returned from an existing credential in credential manager.

This flag is permitted only if GenericCredentials is also specified and is used only in conjunction with GenericCredentials.

RequireSmartCard 256 Use a smart card and prompt for a PIN.

If more than one smart card is available, select one of them.

If the userName parameter passes a string that is not empty, the string must match the UPN associated with the certificate on one of the smart cards.

A UPN matches if the string matches the whole UPN on the certificate or the string matches the part to the left of the at sign (@) in the UPN of the certificate.

If there is a match, the matching smart card is selected.

PasswordOnlyOk 512 Populate the combo box with the password only. Do not allow a user name to be entered.
ValidateUsername 1,024 Check that the user name is valid.
CompleteUsername 2,048 Populate the combo box with the prompt for a user name.
Persist 4,096 Do not show the save message, but save the credential as though the user answered "y" (Yes).
ServerCredential 16,384 This flag is meaningful only in locating a matching credential to prefill the dialog box, should authentication fail.

When this flag is specified, wildcard credentials will not be matched.

It has no effect when writing a credential.

CredUI does not create credentials that contain wildcard characters.

Any found were either created explicitly by the user or created programmatically, as happens when a RAS connection is made.

ExpectConfirmation 131,072 Specifies that the caller will call CredUIConfirmCredentials to determine whether the returned credentials are actually valid.

This ensures that credentials that are not valid are not saved to the credential manager.

Specify this flag unless DoNotPersist is specified.

GenericCredentials 262,144 Consider the credentials entered by the user a generic credential.
Default 393,344 Default behavior.
UsernameTargetCredentials 524,288 The credential is a run-as credential.

The targetName parameter specifies the name of the command or program being run.

It is used for prompting purposes only.

KeepUsername 1,048,576 Do not allow the user to change the supplied user name.

See Also