Método ISCPSecureExchange2::TransferContainerData2 (mswmdm.h)

Artículo
03/15/2023

El método TransferContainerData2 transfiere los datos del archivo de contenedor al proveedor de contenido seguro. El proveedor de contenido seguro desglosa el contenedor internamente e informa de qué partes del contenido están disponibles a medida que se extraen del contenedor. Este método extiende ISCPSecureExchange::TransferContainerData aceptando una devolución de llamada de progreso en la que el proveedor de contenido seguro puede enviar notificaciones de progreso para cualquiera de los pasos que necesita llevar a cabo.

Sintaxis

HRESULT TransferContainerData2(
  [in]      BYTE           *pData,
  [in]      DWORD          dwSize,
  [in]      IWMDMProgress3 *pProgressCallback,
  [out]     UINT           *pfuReadyFlags,
  [in, out] BYTE [8]       abMac
);

Parámetros

[in] pData

Puntero a un búfer que contiene los datos actuales que se transfieren desde el archivo de contenedor. Este parámetro debe incluirse en el código de autenticación del mensaje de entrada y debe cifrarse.

[in] dwSize

DWORD que contiene el número de bytes del búfer. Este parámetro debe incluirse en el código de autenticación del mensaje de entrada.

[in] pProgressCallback

Devolución de llamada de progreso en la que el proveedor de contenido seguro puede notificar el progreso de los pasos que podría necesitar llevar a cabo. El paso se identificará mediante el parámetro EventId de los métodos IWMDMProgress3 .

[out] pfuReadyFlags

Marca que indica qué partes del archivo de contenedor están listas para leerse. Este parámetro se incluye en el código de autenticación del mensaje de salida. Las marcas siguientes indican lo que está listo.

Marca	Descripción
WMDM_SCP_TRANSFER_OBJECTDATA	Los datos del objeto están disponibles llamando al método ObjectData .
WMDM_SCP_NO_MORE_CHANGES	El proveedor de contenido seguro ha determinado que no requiere ningún procesamiento adicional ni modificación del archivo que se va a transferir. Windows Media Administrador de dispositivos puede transferir directamente el resto del archivo al dispositivo.

[in, out] abMac

Matriz de ocho bytes que contiene el código de autenticación de mensajes para los datos de parámetros de este método. (WMDM_MAC_LENGTH se define como 8).

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error HRESULT .

Código devuelto	Descripción
WMDM_E_NOT_CERTIFIED	El autor de la llamada no está autorizado para usar esta interfaz.
WMDM_E_NORIGHTS	El autor de la llamada no tiene los derechos necesarios para realizar la operación solicitada.
WMDM_E_MAC_CHECK_FAILED	El código de autenticación del mensaje no es válido.
S_FALSE	Error en el método. Finalice la interacción con el proveedor de contenido seguro.
E_INVALIDARG	Un parámetro no es válido o es un puntero NULL .
E_FAIL	Se ha producido un error no especificado.

Comentarios

Windows Media Administrador de dispositivos llama repetidamente a este método y transfiere datos del archivo de contenedor al proveedor de contenido seguro. Windows Media Administrador de dispositivos finalmente llama a este método con dwSize establecido en cero para indicar que no tiene más datos que transferir. A medida que el proveedor de contenido seguro recopila los datos y extrae los distintos objetos de él, informa de nuevo a Windows Media Administrador de dispositivos qué objetos, si los hay, están disponibles después de cada llamada. Si no hay ningún objeto disponible, el proveedor de contenido seguro devuelve S_OK con el parámetro pfuReadyFlags establecido en cero. Cuando el proveedor de contenido seguro ha determinado que no requiere ningún procesamiento adicional ni modificación del archivo que se va a transferir, se devuelve la marca WMDM_SCP_NO_MORE_CHANGES. Windows Media Administrador de dispositivos puede transferir directamente el resto del archivo al dispositivo.

Los datos de objeto se transfieren desde el proveedor de contenido seguro llamando al método ObjectData . Windows Media Administrador de dispositivos llama repetidamente a ObjectData hasta que devuelve cero en el segundo parámetro dwBytesWrite.

Windows Media llama al método TransferComplete Administrador de dispositivos para indicar el final de una transferencia segura de datos.

Windows Media Administrador de dispositivos pasa la devolución de llamada de progreso proporcionada por la aplicación al proveedor de contenido seguro en el parámetro pProgressCallback. El proveedor de contenido seguro puede usar este parámetro para proporcionar una notificación de progreso para los pasos que necesita llevar a cabo. El propio paso se identifica mediante EventId, que es el primer parámetro de los métodos de IWMDMProgress3. Una implementación específica del proveedor de contenido seguro definirá valores eventId para que las aplicaciones las usen.