IMFOutputTrustAuthority::SetPolicy メソッド (mfidl.h)

  • [アーティクル]

出力信頼機関 (OTA) に 1 つ以上のポリシー オブジェクトを設定します。

構文

HRESULT SetPolicy(
  [in]  IMFOutputPolicy **ppPolicy,
  [in]  DWORD           nPolicy,
  [out] BYTE            **ppbTicket,
  [out] DWORD           *pcbTicket
);

パラメーター

[in] ppPolicy

IMFOutputPolicy ポインターの配列のアドレス。

[in] nPolicy

ppPolicy 配列内の要素の数。

[out] ppbTicket

OTA によって割り当てられたバッファーへのポインターまたは値 NULL を受け取ります。 このパラメーターが NULL 以外の値を受け取る場合、呼び出し元は CoTaskMemFree を呼び出してバッファーを解放する必要があります。

メモ 現在、このパラメーターは予約されています。 OTA はポインターを NULL に設定する必要があります。
 

[out] pcbTicket

ppbTicket バッファーのサイズをバイト単位で受け取ります。 ppbTicket が値 NULL を受け取った場合、pcbTicket は値 0 を受け取ります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_S_WAIT_FOR_POLICY_SET
 ポリシーは正常にネゴシエートされましたが、OTA によって非同期的に適用されます。
MF_E_POLICY_UNSUPPORTED
 OTA は、このポリシーの要件をサポートしていません。

解説

メソッドが MF_S_WAIT_FOR_POLICY_SETを返す場合、OTA はポリシーを適用するときに MEPolicySet イベントを送信します。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfidl.h
Library Mfuuid.lib

関連項目

IMFOutputTrustAuthority