ISCPSecureExchange::TransferContainerData-Methode (mswmdm.h)
Die TransferContainerData-Methode überträgt Containerdateidaten an den anbieter für sichere Inhalte. Der Anbieter für sichere Inhalte unterteilt den Container intern und meldet, welche Teile des Inhalts verfügbar sind, wenn sie aus dem Container extrahiert werden.
Syntax
HRESULT TransferContainerData(
[in] BYTE *pData,
[in] DWORD dwSize,
[out] UINT *pfuReadyFlags,
[in, out] BYTE [8] abMac
);
Parameter
[in] pData
Zeiger auf einen Puffer, der die aktuellen Daten enthält, die aus der Containerdatei übertragen werden. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein und verschlüsselt sein.
[in] dwSize
DWORD , das die Anzahl der Bytes im Puffer enthält. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein.
[out] pfuReadyFlags
Flag, das angibt, welche Teile der Containerdatei gelesen werden können. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten. Die folgenden Flags geben an, was bereit ist.
| Flag | Beschreibung |
|---|---|
| WMDM_SCP_TRANSFER_OBJECTDATA | Daten des Objekts sind durch Aufrufen der ObjectData-Methode verfügbar. |
| WMDM_SCP_NO_MORE_CHANGES | Legen Sie fest, wenn der Anbieter sicherer Inhalte festgestellt hat, dass keine weitere Verarbeitung und/oder Änderung der übertragenen Datei erforderlich ist. Windows Media-Geräte-Manager können den Rest der Datei direkt auf das Gerät übertragen. |
[in, out] abMac
Array von acht Bytes, das den Nachrichtenauthentifizierungscode für die Parameterdaten dieser Methode enthält. (WMDM_MAC_LENGTH ist als 8 definiert.)
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Aufrufer ist nicht autorisiert, diese Schnittstelle zu verwenden. |
|
Der Aufrufer verfügt nicht über die erforderlichen Rechte, um den angeforderten Vorgang auszuführen. |
|
Der Nachrichtenauthentifizierungscode ist ungültig. |
|
Fehler bei der Methode. Beenden Sie die Interaktion mit dem anbieter für sichere Inhalte. |
|
Ein Parameter ist ungültig oder ein NULL-Zeiger . |
|
Es ist ein unbekannter Fehler aufgetreten. |
Hinweise
Windows Media Geräte-Manager ruft diese Methode wiederholt auf und überträgt Daten aus der Containerdatei an den sicheren Inhaltsanbieter. Windows Media Geräte-Manager ruft schließlich diese Methode auf, wobei dwSize auf 0 festgelegt ist, um anzugeben, dass keine weiteren Daten übertragen werden. Da der Anbieter für sichere Inhalte die Daten sammelt und die verschiedenen Objekte daraus extrahiert, meldet er Windows Media Geräte-Manager welche Objekte nach jedem Aufruf verfügbar sind. Wenn keine Objekte verfügbar sind, gibt der Anbieter für sichere Inhalte S_OK zurück, wobei der pfuReadyFlags-Parameter auf null festgelegt ist. Wenn der Anbieter sicherer Inhalte festgestellt hat, dass keine weitere Verarbeitung und/oder Änderung der übertragenen Datei erforderlich ist, wird das Flag WMDM_SCP_NO_MORE_CHANGES zurückgegeben. Windows Media Geräte-Manager können dann den Rest der Datei direkt auf das Gerät übertragen.
Objektdaten werden vom anbieter für sichere Inhalte übertragen, indem die ObjectData-Methode aufgerufen wird . Windows Media Geräte-Manager wiederholt ObjectData aufruft, bis im zweiten Parameter dwBytesWrite null zurückgegeben wird.
Die TransferComplete-Methode wird von Windows Media Geräte-Manager aufgerufen, um das Ende einer sicheren Datenübertragung zu signalisieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |