Método ISCPSecureExchange::TransferContainerData (mswmdm.h)
El método TransferContainerData 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.
Sintaxis
HRESULT TransferContainerData(
[in] BYTE *pData,
[in] DWORD dwSize,
[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.
[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 | Se establece 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. 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 |
|---|---|
|
El autor de la llamada no está autorizado para usar esta interfaz. |
|
El autor de la llamada no tiene los derechos necesarios para realizar la operación solicitada. |
|
El código de autenticación del mensaje no es válido. |
|
Error en el método. Finalice la interacción con el proveedor de contenido seguro. |
|
Un parámetro no es válido o es un puntero NULL . |
|
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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |