MICROSOFT_PRESS_EBOOK_PROGRAMMING_WINDOWS_8_APPS_WITH_HTML_CSS_AND_JAVASCRIPT_PDF

The result from pickAsync, as given to your completed handler, is a CredentialPickerResults
object with the following properties—when you enter some credentials in the sample here, you’ll see
these values reflected in the sample’s output:
• credentialuserName A string containing the entered username.
• credentialPassword A string containing the password (typically encrypted depending on the
authentication protocol option).
• credentialDomainName A string containing a domain if entered with the username (as in
\).
• credentialSaved A Boolean indicating whether the credential was saved automatically; this
depends on picker options, as discussed below.
• credentialSavedOption A CredentialSavedOption value indicating the state of the
Remember My Credentals check box: unselected, selected, or hidden. We’ll see how to handle
this shortly as well.
• errorCode Contains zero if there is no error, otherwise an error code.
• credential An IBuffer containing the credential as an opaque byte array. This is what you can
save in your own persistent state if needs be and passed back to the picker at a later time; we’ll
see how shortly.
The three scenarios in the sample demonstrate the different options you can use to invoke the
credential picker. For this there are three separate variants of pickAsync. The first variant accepts a
target name (ignored) and a message string that appears in the place of “Please enter your credentials”
in Figure 14-2:
Windows.Security.Credentials.UI.CredentialPicker.pickAsync(targetName, message)
.done(function (results) {
}
The second variant accepts the same arguments plus a caption string that appears in the place of
“Credential Picker Sample” in Figure 14-2:
Windows.Security.Credentials.UI.CredentialPicker.pickAsync(targetName, message, caption)
.done(function (results) {
}
The third variant accepts a CredentialPickerOptions object that has properties for the same
targetName, message, and caption strings along with the following:
• previousCredential An IBuffer with the opaque credential information as provided by a
previous invocation of the picker (see CredentialPickerResults.credential above).
• alwaysDisplayDialog A Boolean indicating whether the dialog box is displayed. The default
value is false, but this applies only if you also populate previousCredential (with an exception
657