[This documentation is preliminary and is subject to change.]

Contains flags for the MFP_ACQUIRE_USER_CREDENTIAL_EVENT structure.

Some of these flags, marked [out], convey information back to the MFPlay player object. The application should set or clear these flags as appropriate, before returning from the IMFPMediaPlayerCallback::OnMediaPlayerEvent callback method.


typedef enum _tagMFP_CREDENTIAL_FLAGS {
  MFP_CREDENTIAL_PROMPT           = 0x00000001,
  MFP_CREDENTIAL_SAVE             = 0x00000002,
  MFP_CREDENTIAL_DO_NOT_CACHE     = 0x00000004,
  MFP_CREDENTIAL_CLEAR_TEXT       = 0x00000008,
  MFP_CREDENTIAL_PROXY            = 0x00000010,


    The player object does not have any stored credentials and requires them from the application. If the player object can provide cached or stored credentials to the server, it does not set this flag.

    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.

    [out] If the application sets this flag, the player object saves the user credentials in persistent storage. Otherwise, the player object does not save the credentials.

    [out] If the application sets this flag, the player object does not cache the user credentials in memory. Otherwise, the player object does not cache the credentials. If you set this flag, do not set the MFP_CREDENTIAL_SAVE flag.

    The credentials will be sent in clear text. The application should warn the user that the credentials will be sent over the network without encryption.

    [out] On output, set this flag to allow the player object to send credentials in clear text, without prompting the user to re-enter the credentials.

    The credentials will be used to authenticate with a proxy.

    The authentication scheme supports authentication of the user who is currently logged on.


Client Requires Windows 7.
Header Declared in Mfplay.h.
IDL Declared in Mfplay.idl.

Send comments about this topic to Microsoft

Build date: 4/3/2009