Metodo ISCPSecureExchange2::TransferContainerData2 (mswmdm.h)

Articolo
03/05/2024

Il metodo TransferContainerData2 trasferisce i dati del file contenitore al provider di contenuto sicuro. Il provider di contenuto sicuro suddivide il contenitore internamente e segnala quali parti del contenuto sono disponibili man mano che vengono estratte dal contenitore. Questo metodo estende ISCPSecureExchange::TransferContainerData accettando un callback di stato in cui il provider di contenuto sicuro può inviare notifiche di stato per qualsiasi procedura da eseguire.

Sintassi

HRESULT TransferContainerData2(
  [in]      BYTE           *pData,
  [in]      DWORD          dwSize,
  [in]      IWMDMProgress3 *pProgressCallback,
  [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.

[in] pProgressCallback

Callback dello stato in cui il provider di contenuto sicuro può segnalare lo stato di avanzamento di qualsiasi passaggio che potrebbe essere necessario eseguire. Il passaggio verrà identificato dal parametro EventId dei metodi IWMDMProgress3 .

[out] pfuReadyFlags

Flag che indica quali parti del file 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	Il provider di contenuto sicuro ha determinato che non richiede ulteriore elaborazione e/o modifica del file in corso 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 dei messaggi 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
WMDM_E_NOT_CERTIFIED	Il chiamante non è autorizzato a usare questa interfaccia.
WMDM_E_NORIGHTS	Il chiamante non dispone dei diritti necessari per eseguire l'operazione richiesta.
WMDM_E_MAC_CHECK_FAILED	Il codice di autenticazione del messaggio non è valido.
S_FALSE	Il metodo non è riuscito. Terminare l'interazione con il provider di contenuto sicuro.
E_INVALIDARG	Un parametro non è valido o è un puntatore NULL .
E_FAIL	Si è verificato un errore non specificato.

Commenti

Windows Media Gestione dispositivi chiama ripetutamente questo metodo, trasferendo i dati dal file contenitore al provider di contenuto sicuro. Windows Media Gestione dispositivi chiama infine questo metodo con dwSize impostato su zero per indicare che non ha più dati da trasferire. Poiché il provider di contenuto sicuro raccoglie i dati ed estrae i vari oggetti da esso, segnala di nuovo a Windows Media Gestione dispositivi quali oggetti, se presenti, sono disponibili dopo ogni chiamata. Se non sono disponibili oggetti, il provider di contenuto sicuro restituisce S_OK con il parametro pfuReadyFlags impostato su zero. Quando il provider di contenuto sicuro ha determinato che non richiede ulteriore elaborazione e/o modifica 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 dell'oggetto vengono trasferiti dal provider di contenuto sicuro chiamando il metodo ObjectData . Windows Media Gestione dispositivi chiama ObjectData ripetutamente 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.

Windows Media Gestione dispositivi passa il callback dello stato fornito dall'applicazione al provider di contenuto sicuro nel parametro pProgressCallback. Il provider di contenuto sicuro può usare questo parametro per fornire una notifica di stato per qualsiasi procedura da eseguire. Il passaggio stesso è identificato da EventId, ovvero il primo parametro dei metodi di IWMDMProgress3. Un'implementazione specifica del provider di contenuto sicuro definirà valori EventId da usare per le applicazioni.