MFP_ACQUIRE_USER_CREDENTIAL_EVENT-Struktur (mfplay.h)

  • Artikel
Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.
 

Ereignisstruktur für das MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL-Ereignis . Dieses Ereignis wird gesendet, wenn die Anwendung eine Mediendatei von einem Server wiedergibt, der eine Authentifizierung erfordert. Die Anwendung kann reagieren, indem sie die Anmeldeinformationen des Benutzers bereitstellt.

Syntax

typedef struct MFP_ACQUIRE_USER_CREDENTIAL_EVENT {
  MFP_EVENT_HEADER     header;
  DWORD_PTR            dwUserData;
  BOOL                 fProceedWithAuthentication;
  HRESULT              hrAuthenticationStatus;
  LPCWSTR              pwszURL;
  LPCWSTR              pwszSite;
  LPCWSTR              pwszRealm;
  LPCWSTR              pwszPackage;
  LONG                 nRetries;
  MFP_CREDENTIAL_FLAGS flags;
  IMFNetCredential     *pCredential;
} MFP_ACQUIRE_USER_CREDENTIAL_EVENT;

Member

header

MFP_EVENT_HEADER Struktur, die Daten enthält, die allen IMFPMediaPlayer-Ereignissen gemeinsam sind.

dwUserData

Anwendungsdefinierte Benutzerdaten für das Medienelement. Dieser Wert wird angegeben, wenn die Anwendung IMFPMediaPlayer::CreateMediaItemFromURL oder IMFPMediaPlayer::CreateMediaItemFromObject aufruft , um das Medienelement zu erstellen.

Dieses Ereignis wird (falls überhaupt) gesendet, bevor das Medienelement erstellt wird und bevor die Anwendung das MFP_EVENT_TYPE_MEDIAITEM_CREATED-Ereignis empfängt. Sie können den Wert von dwUserData verwenden, um zu ermitteln, welches Medienelement eine Authentifizierung erfordert.

fProceedWithAuthentication

Die Anwendung sollte diesen Member auf TRUE oder FALSE festlegen, bevor sie vom IMFPMediaPlayerCallback::OnMediaPlayerEvent-Ereignisrückruf zurückgegeben wird.

Wenn der Wert TRUE ist, wenn der Rückruf zurückgibt, setzt MFPlay den Authentifizierungsversuch fort. Andernfalls schlägt die Authentifizierung fehl.

hrAuthenticationStatus

Der Antwortcode der Authentifizierungsanforderung.

pwszURL

Die ursprüngliche URL, die eine Authentifizierung erfordert.

pwszSite

Der Name des Standorts oder Proxys, für den eine Authentifizierung erforderlich ist.

pwszRealm

Der Name des Bereichs für diese Authentifizierung.

pwszPackage

Der Name des Authentifizierungspakets, z. B. "Digest" oder "MBS_BASIC".

nRetries

Die Anzahl der Wiederholungen. Dieses Element wird beim ersten Versuch auf Null festgelegt und für jeden nachfolgenden Versuch einmal erhöht.

flags

Bitweise OR mit null oder mehr Flags aus der _MFP_CREDENTIAL_FLAGS-Enumeration .

pCredential

Zeiger auf die IMFNetCredential-Schnittstelle . Die Anwendung verwendet diese Schnittstelle, um die Anmeldeinformationen des Benutzers festzulegen.

Hinweise

Um einen Zeiger auf diese Struktur abzurufen, wandeln Sie den pEventHeader-Parameter der IMFPMediaPlayerCallback::OnMediaPlayerEvent-Rückrufmethode um. Zu diesem Zweck können Sie das Makro MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT verwenden.

Wenn das Flags-Element das MFP_CREDENTIAL_PROMPT-Flag enthält, sollte die Anwendung folgendes tun:

  1. Fordern Sie den Benutzer auf, einen Benutzernamen und ein Kennwort einzugeben.
  2. Speichern Sie den Benutzernamen im Anmeldeinformationsobjekt, indem Sie IMFNetCredential::SetUser auf dem pCredential-Zeiger aufrufen.
  3. Speichern Sie das Kennwort, indem Sie IMFNetCredential::SetPassword auf dem pCredential-Zeiger aufrufen.
Um die Authentifizierung abzubrechen, legen Sie fProceedWithAuthentication auf FALSE fest.

Standardmäßig verwendet MFPlay die Implementierung von IMFNetCredentialManager der Netzwerkquelle, um Anmeldeinformationen zu verwalten. Eine Anwendung kann eine eigene Implementierung dieser Schnittstelle wie folgt bereitstellen:

  1. Rufen Sie QueryInterface auf dem IMFPMediaPlayer-Zeiger auf, um die IPropertyStore-Schnittstelle abzurufen.
  2. Rufen Sie IPropertyStore::SetValue auf, um die eigenschaft MFNETSOURCE_CREDENTIAL_MANAGER festzulegen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile mfplay.h

Weitere Informationen

IMFPMediaPlayerCallback

Medienfundamentstrukturen

Verwenden von MFPlay für die Audio-/Videowiedergabe