Método IMFInputTrustAuthority::RequestAccess (mfidl.h)

Solicita permiso para realizar una acción especificada en la secuencia.

Sintaxis

HRESULT RequestAccess(
  [in]  MFPOLICYMANAGER_ACTION Action,
  [out] IMFActivate            **ppContentEnablerActivate
);

Parámetros

[in] Action

Acción solicitada, especificada como miembro de la enumeración MFPOLICYMANAGER_ACTION .

[out] ppContentEnablerActivate

Recibe el valor NULL o un puntero a la interfaz IMFActivate . La interfaz IMFActivate se usa para crear un objeto de habilitador de contenido. El autor de la llamada debe liberar la interfaz . Para obtener más información, vea la sección Comentarios.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El usuario tiene permiso para realizar esta acción.
NS_E_DRM_NEEDS_INDIVIDUALIZATION	El usuario debe individualizar la aplicación.
NS_E_LICENSE_REQUIRED	El usuario debe obtener una licencia.

Comentarios

Este método comprueba si el usuario tiene permiso para realizar una acción especificada en la secuencia. ItA realiza cualquier trabajo necesario para comprobar el derecho del usuario a realizar la acción, como la comprobación de licencias.

Para comprobar los derechos del usuario, es posible que el ITA tenga que realizar pasos adicionales que requieran la interacción con el usuario o el consentimiento del usuario. Por ejemplo, puede que tenga que adquirir una nueva licencia o individualizar un componente DRM. En ese caso, el ITA crea un objeto de activación para un habilitador de contenido y devuelve la interfaz IMFActivate del objeto de activación en el parámetro ppContentEnablerActivate . El objeto de activación es responsable de crear un habilitador de contenido que expone la interfaz IMFContentEnabler . El habilitador de contenido se usa de la siguiente manera:

1. La sesión multimedia devuelve el puntero IMFActivate a la aplicación.
2. La aplicación llama a IMFActivate::ActivateObject para activar el habilitador de contenido.
3. La aplicación llama a los métodos IMFContentEnabler para realizar las acciones necesarias, como la individualización o la obtención de una licencia. El objeto del habilitador de contenido debe encapsular esta funcionalidad a través de la interfaz IMFContentEnabler .
4. La sesión multimedia llama de nuevo a RequestAccess .

El valor devuelto indica si el usuario tiene permiso para realizar la acción:

• Si el usuario ya tiene permiso para realizar la acción, el método devuelve S_OK y establece *ppContentEnablerActivate en NULL.
• Si el usuario no tiene permiso, el método devuelve un código de error y establece *ppContentEnablerActivate en NULL.
• Si el ITA debe realizar pasos adicionales que requieran interacción con el usuario, el método devuelve un código de error y devuelve el puntero IMFActivate del habilitador de contenido en ppContentEnablerActivate.

La sesión multimedia no permitirá la acción a menos que este método devuelva S_OK. Sin embargo, un valor devuelto de S_OK no garantiza que se realice la acción, ya que puede producirse algún otro error después de llamar a este método. Cuando la acción está definitivamente a punto de suceder, la sesión multimedia llama a IMFInputTrustAuthority::BindAccess.

Una secuencia puede ir a varias salidas, por lo que este método puede llamarse varias veces con acciones diferentes, una vez por cada salida.

Requisitos

Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfuuid.lib

Consulte también

IMFInputTrustAuthority