MFP_ACQUIRE_USER_CREDENTIAL_EVENT 構造体 (mfplay.h)

  • [アーティクル]
大事な 廃止。 この API は、Windows の今後のリリースから削除される可能性があります。 アプリケーションでは、再生に メディア セッション を使用する必要があります。
 

MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL イベントのイベント構造。 このイベントは、アプリケーションが認証を必要とするサーバーからメディア ファイルを再生する場合に送信されます。 アプリケーションは、ユーザーの資格情報を指定して応答できます。

構文

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;

メンバー

header

すべてのIMFPMediaPlayer イベントに共通するデータを含むMFP_EVENT_HEADER構造体。

dwUserData

メディア項目のアプリケーション定義ユーザー データ。 この値は、アプリケーションが IMFPMediaPlayer::CreateMediaItemFromURL または IMFPMediaPlayer::CreateMediaItemFromObject を呼び出してメディアアイテムを作成するときに指定されます。

このイベントは、メディア項目が作成される前と、アプリケーションが MFP_EVENT_TYPE_MEDIAITEM_CREATED イベントを受信する前に送信されます (すべてである場合)。 dwUserData の値を使用して、認証が必要なメディア 項目を特定できます。

fProceedWithAuthentication

アプリケーションは、IMFPMediaPlayerCallback::OnMediaPlayerEvent イベント コールバックから戻る前に、このメンバーを TRUE または FALSE に設定する必要があります。

コールバックが戻るときに値が TRUE の 場合、MFPlay は認証の試行を続行します。 それ以外の場合、認証は失敗します。

hrAuthenticationStatus

認証チャレンジの応答コード。

pwszURL

認証を必要とする元の URL。

pwszSite

認証を必要とするサイトまたはプロキシの名前。

pwszRealm

この認証の領域の名前。

pwszPackage

認証パッケージの名前 ("Digest" や "MBS_BASIC" など)。

nRetries

再試行回数。 このメンバーは、最初の試行では 0 に設定され、後続の試行ごとに 1 回インクリメントされます。

flags

_MFP_CREDENTIAL_FLAGS列挙からの 0 個以上のフラグのビットごとの OR。

pCredential

IMFNetCredential インターフェイスへのポインター。 アプリケーションでは、このインターフェイスを使用してユーザーの資格情報を設定します。

注釈

この構造体へのポインターを取得するには、IMFPMediaPlayerCallback::OnMediaPlayerEvent コールバック メソッドの pEventHeader パラメーターをキャストします。 この目的には 、MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT マクロを使用できます。

flags メンバーに MFP_CREDENTIAL_PROMPT フラグが含まれている場合、アプリケーションは次の操作を行う必要があります。

  1. ユーザー名とパスワードを入力するようにユーザーに求めます。
  2. pCredential ポインターで IMFNetCredential::SetUser を呼び出して、資格情報オブジェクトにユーザー名を格納します。
  3. pCredential ポインターで IMFNetCredential::SetPassword を呼び出してパスワードを格納します。
認証を取り消すには、 fProceedWithAuthentication を FALSE に設定 します。

既定では、MFPlay はネットワーク ソースの IMFNetCredentialManager の実装を使用して資格情報を管理します。 アプリケーションは、次のように、このインターフェイスの独自の実装を提供できます。

  1. IPropertyStore インターフェイスを取得するには、IMFPMediaPlayer ポインターで QueryInterface を呼び出します。
  2. IPropertyStore::SetValue を呼び出して、MFNETSOURCE_CREDENTIAL_MANAGER プロパティを設定します。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header mfplay.h

こちらもご覧ください

IMFPMediaPlayerCallback

Media Foundation Structures

オーディオ/ビデオ再生に MFPlay を使用する