Método IWMDRMSecurity::P erformSecurityUpdate
[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 PerformSecurityUpdate inicia una actualización de seguridad en el subsistema DRM del equipo local.
Sintaxis
HRESULT PerformSecurityUpdate(
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
Parámetros
-
dwFlags [in]
-
Opción de actualización expresada como una de las marcas siguientes.
Marca Descripción WMDRM_SECURITY_PERFORM_INDIV Hace que el componente DRM se individualice solo si la versión del cliente no está actualizada. WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH Hace que las listas de revocación del equipo cliente se actualicen. WMDRM_SECURITY_PERFORM_FORCE_INDIV Hace que el componente DRM se individualice incluso si la versión del cliente está actualizada. -
ppunkCancelationCookie [out]
-
Dirección de una variable que recibe un puntero a un objeto que se puede usar para cancelar esta operación.
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 |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
Observaciones
Este método se ejecuta de forma asincrónica. Devuelve inmediatamente después de llamar a y, a continuación, genera eventos en función de la marca establecida en el parámetro dwFlags .
Para la individualización (marca establecida en WMDRM_SECURITY_PERFORM_INDIV o WMDRM_SECURITY_PERFORM_FORCE_INDIV), se genera una serie de eventos MEWMDRMIndividualizationProgress seguido de un evento MEWMDRMIndividualizationCompleted cuando se completa el procesamiento. El valor de cada uno de los eventos MEWMDRMIndividualizationProgress obtenidos llamando a IMFMediaEvent::GetValue es un puntero IUnknown . Puede llamar al método QueryInterface de la interfaz IUnknown recuperada para obtener una instancia de la interfaz IWMDRMIndividualizationStatus .
Para actualizar las listas de revocación (marca establecida en WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH), se genera un evento MEWMDRMREvocationDownloadCompleted cuando se completa el procesamiento.
Nota
Cuando PerformSecurityUpdate completa la individualización, los únicos objetos existentes que reflejarán el nuevo estado individualizado son los que heredan de IWMDRMSecurity. No se actualizarán todos los demás objetos existentes. Debe liberar y volver a crear cualquier otro objeto para que reflejen el nuevo estado individualizado.
Para obtener más información sobre el uso de los métodos asincrónicos de las API extendidas del cliente DRM de Windows Media, vea Uso del modelo de eventos de Media Foundation.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|