Edit

Share via

MFNetCredentialRequirements enumeration (mfidl.h)

  • Article

Specifies how the credential manager should obtain user credentials.

Syntax

typedef enum _MFNetCredentialRequirements {
  REQUIRE_PROMPT = 0x1,
  REQUIRE_SAVE_SELECTED = 0x2
} MFNetCredentialRequirements;

Constants

 
REQUIRE_PROMPT
Value: 0x1
The credential manager should prompt the user to provide the credentials.
REQUIRE_SAVE_SELECTED
Value: 0x2
Note  Requires Windows 7 or later.

 



The credentials are saved to persistent storage. This flag acts as a hint for the application's UI. If the application prompts the user for credentials, the UI can indicate that the credentials have already been saved.

Remarks

The application implements the credential manager, which must expose the IMFNetCredentialManager interface. If the REQUIRE_PROMPT flag is set, the credential manager should prompt the user for his or her name and password.

The credential cache object sets the REQUIRE_PROMPT flag if the cache does not yet contain valid credentials. It also sets this flag if the credentials will be sent as plain text, unless the credential manager previously set the MFNET_CREDENTIAL_ALLOW_CLEAR_TEXT option. (See IMFNetCredentialCache::SetUserOptions.)

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header mfidl.h

See also

IMFNetCredentialCache::GetCredential

Media Foundation Enumerations

Network Source Authentication