_MFP_CREDENTIAL_FLAGS enumeration (mfplay.h)

[The feature associated with this page, MFPlay, is a legacy feature. It has been superseded by MediaPlayer and IMFMediaEngine. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer and IMFMediaEngine instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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.

Syntax

typedef enum _MFP_CREDENTIAL_FLAGS {
  MFP_CREDENTIAL_PROMPT = 0x1,
  MFP_CREDENTIAL_SAVE = 0x2,
  MFP_CREDENTIAL_DO_NOT_CACHE = 0x4,
  MFP_CREDENTIAL_CLEAR_TEXT = 0x8,
  MFP_CREDENTIAL_PROXY = 0x10,
  MFP_CREDENTIAL_LOGGED_ON_USER = 0x20
} ;

Constants

 
MFP_CREDENTIAL_PROMPT
Value: 0x1
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.
MFP_CREDENTIAL_SAVE
Value: 0x2
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.
MFP_CREDENTIAL_DO_NOT_CACHE
Value: 0x4
[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.
MFP_CREDENTIAL_CLEAR_TEXT
Value: 0x8
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.
MFP_CREDENTIAL_PROXY
Value: 0x10
The credentials will be used to authenticate with a proxy.
MFP_CREDENTIAL_LOGGED_ON_USER
Value: 0x20
The authentication scheme supports authentication of the user who is currently logged on.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header mfplay.h

See also

Media Foundation Enumerations