ISCPSecureExchange2::TransferContainerData2-Methode (mswmdm.h)

Artikel
02/29/2024

Die TransferContainerData2-Methode überträgt Containerdateidaten an den sicheren Inhaltsanbieter. 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. Diese Methode erweitert ISCPSecureExchange::TransferContainerData , indem sie einen Statusrückruf akzeptiert, für den der anbieter für sichere Inhalte Statusbenachrichtigungen für alle erforderlichen Schritte senden kann.

Syntax

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

[in] pProgressCallback

Statusrückruf, bei dem der Anbieter für sichere Inhalte den Fortschritt aller Schritte melden kann, die er möglicherweise ausführen muss. Der Schritt wird durch den EventId-Parameter der IWMDMProgress3-Methoden identifiziert.

[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	Der Anbieter sicherer Inhalte hat festgestellt, 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
WMDM_E_NOT_CERTIFIED	Der Aufrufer ist nicht autorisiert, diese Schnittstelle zu verwenden.
WMDM_E_NORIGHTS	Der Aufrufer verfügt nicht über die erforderlichen Rechte, um den angeforderten Vorgang auszuführen.
WMDM_E_MAC_CHECK_FAILED	Der Nachrichtenauthentifizierungscode ist ungültig.
S_FALSE	Fehler bei der Methode. Beenden Sie die Interaktion mit dem anbieter für sichere Inhalte.
E_INVALIDARG	Ein Parameter ist ungültig oder ein NULL-Zeiger .
E_FAIL	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.

Windows Media Geräte-Manager übergibt den von der Anwendung bereitgestellten Statusrückruf an den Anbieter für sichere Inhalte im Parameter pProgressCallback. Der Anbieter für sichere Inhalte kann diesen Parameter verwenden, um statusbenachrichtigungen für alle Schritte bereitzustellen, die er ausführen muss. Der Schritt selbst wird durch EventId identifiziert, bei dem es sich um den ersten Parameter der Methoden von IWMDMProgress3 handelt. Eine bestimmte Sichere Inhaltsanbieterimplementierung definiert EventId-Werte für zu verwendende Anwendungen.