Método IWMDRMSecurity::GetContentEnablersFromHashes

[La característica asociada a esta página, WINDOWS Media Format 11 SDK, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. Lector de origen y escritor receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector fuente 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 GetContentEnablersFromHashes recupera interfaces del habilitador de contenido que habilitan la renovación de componentes basados en certificados hash.

Sintaxis

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parámetros

rgpbCertHashes [in]

Matriz de hashes de certificado para la que se obtienen los habilitadores de contenido.

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 rgpbCertHashes .

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 hacerse 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. Un identificador único que identifica el componente revocado se envía 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

Interfaz IWMDRMSecurity