IWMDRMSecurity::GetContentEnablersForRevocations (método)

Artículo
06/21/2023

[La característica asociada a esta página, SDK de Windows Media Format 11, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. El lector de origen y el sistema de escritura receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector de origen y escritor receptor en lugar del SDK de Windows Media Format 11, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método GetContentEnablersForRevocations recupera interfaces de habilitador de contenido que habilitan la renovación de componentes basados en certificados revocados.

Sintaxis

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parámetros

rgpbCerts [in]

Matriz de certificados para la que se van a recuperar los habilitadores de contenido. CCerts debe especificar el número de elementos de la matriz.

rgpdwCertSizes [in]

Matriz que contiene los tamaños de los certificados en la matriz rgpbCerts . CCerts debe especificar el número de elementos de la matriz.

rgpguidCerts [in]

Matriz que contiene los tipos de los certificados de la matriz rgpbCerts . CCerts debe especificar el número de elementos de la matriz. Para cada elemento de la matriz, use uno de los valores siguientes.

Constante GUID	Descripción
WMDRM_REVOCATIONTYPE_APP	Especifica un certificado de aplicación.
WMDRM_REVOCATIONTYPE_DEVICE	Especifica un certificado de dispositivo.
WMDRM_REVOCATIONTYPE_CARDEA	Especifica un DRM de Windows Media para el certificado de dispositivos de red.

cCerts [in]

Número de certificados para los que se van a recuperar los habilitadores de contenido. Este es el número de elementos de la matriz rgpbCerts , la matriz rgpdwCertSizes y la matriz rgpguidCerts .

hResultHint [in]

Valor devuelto recibido de la operación que produjo un error debido a un certificado revocado. Si no llama a en respuesta a una llamada de método con error, establezca en S_OK.

prgContentEnablers [out]

Matriz que recibe las direcciones de las interfaces IMFContentEnabler recién creadas. Establezca en NULL para obtener el número de habilitadores de contenido en el parámetro pcContentEnablers .

pcContentEnablers [in, out]

Número de elementos de la matriz prgContentEnablers . Si prgContentEnablers es NULL, este valor se establece en el número de habilitadores de contenido necesarios en la salida.

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 método se ha llevado a cabo de forma correcta.

Observaciones

Si usa la interfaz IMFContentEnabler para renovar los componentes revocados, debe aclarar el proceso al usuario. Esta aclaración debe realizarse porque el proceso de actualización envía información del equipo cliente a un sitio web de Microsoft.

Al llamar a IMFContentEnabler::AutomaticEnable, el habilitador de contenido inicia el explorador predeterminado con la dirección del servicio de actualización en el sitio web de Microsoft. Se envía un identificador único que identifica el componente revocado al servicio de actualización. A continuación, el servicio redirige el explorador a una página web desde la que el usuario puede descargar e instalar la nueva versión del componente revocado.

Requisitos

Requisito	Value
Encabezado	Wmdrmsdk.h
Biblioteca	Wmdrmsdk.lib

Consulte también

Revocación y renovación automatizadas de componentes
IWMDRMSecurity (Interfaz)

Share via