Metodo ISCPSecureExchange::TransferContainerData (mswmdm.h)
Il metodo TransferContainerData trasferisce i dati dei file del contenitore al provider di contenuti sicuro. Il provider di contenuti sicuri suddivide internamente il contenitore e segnala quali parti del contenuto sono disponibili man mano che vengono estratte dal contenitore.
Sintassi
HRESULT TransferContainerData(
[in] BYTE *pData,
[in] DWORD dwSize,
[out] UINT *pfuReadyFlags,
[in, out] BYTE [8] abMac
);
Parametri
[in] pData
Puntatore a un buffer che contiene i dati correnti trasferiti dal file del contenitore. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input e deve essere crittografato.
[in] dwSize
DWORD contenente il numero di byte nel buffer. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input.
[out] pfuReadyFlags
Flag che indica quali parti del file del contenitore sono pronte per la lettura. Questo parametro è incluso nel codice di autenticazione del messaggio di output. I flag seguenti indicano cosa è pronto.
| Flag | Descrizione |
|---|---|
| WMDM_SCP_TRANSFER_OBJECTDATA | I dati dell'oggetto sono disponibili chiamando il metodo ObjectData . |
| WMDM_SCP_NO_MORE_CHANGES | Impostare quando il provider di contenuti protetti ha determinato che non richiede ulteriori elaborazioni e/o modifiche del file in fase di trasferimento. Windows Media Gestione dispositivi può trasferire direttamente il resto del file nel dispositivo. |
[in, out] abMac
Matrice di otto byte contenente il codice di autenticazione del messaggio per i dati dei parametri di questo metodo. (WMDM_MAC_LENGTH è definito come 8.)
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, restituisce un codice di errore HRESULT .
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante non è autorizzato a usare questa interfaccia. |
|
Il chiamante non dispone dei diritti necessari per eseguire l'operazione richiesta. |
|
Il codice di autenticazione del messaggio non è valido. |
|
Il metodo non è riuscito. Terminare l'interazione con il provider di contenuti protetti. |
|
Un parametro non è valido o è un puntatore NULL . |
|
Si è verificato un errore non specificato. |
Commenti
Windows Media Gestione dispositivi chiama ripetutamente questo metodo, trasferendo i dati dal file del contenitore al provider di contenuti sicuro. Windows Media Gestione dispositivi chiama infine questo metodo con dwSize impostato su zero per indicare che non contiene più dati da trasferire. Poiché il provider di contenuti protetti raccoglie i dati ed estrae i vari oggetti da esso, restituisce a Windows Media Gestione dispositivi quali oggetti, se presenti, sono disponibili dopo ogni chiamata. Se non sono disponibili oggetti, il provider di contenuti protetti restituisce S_OK con il parametro pfuReadyFlags impostato su zero. Quando il provider di contenuti protetti ha stabilito che non richiede ulteriori elaborazioni e/o modifiche del file da trasferire, viene restituito il flag WMDM_SCP_NO_MORE_CHANGES. Windows Media Gestione dispositivi può quindi trasferire direttamente il resto del file nel dispositivo.
I dati oggetto vengono trasferiti dal provider di contenuti protetti chiamando il metodo ObjectData . Windows Media Gestione dispositivi chiama ripetutamente ObjectData fino a quando non restituisce zero nel secondo parametro, dwBytesWrite.
Il metodo TransferComplete viene chiamato da Windows Media Gestione dispositivi per segnalare la fine di un trasferimento sicuro dei dati.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |