Metodo IWMDMStorage4::GetRightsWithProgress (mswmdm.h)

Articolo
03/13/2024

Il metodo GetRightsWithProgress recupera le informazioni sui diritti per l'oggetto di archiviazione, fornendo un meccanismo di callback per il monitoraggio dello stato di avanzamento.

Sintassi

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

Parametri

[in] pIProgressCallback

Puntatore facoltativo a un'interfaccia IWMDMProgress3 da usare da Windows Media Gestione dispositivi per segnalare lo stato di avanzamento all'applicazione.

[out] ppRights

Puntatore a una matrice di strutture WMDMRIGHTS che contengono le informazioni sui diritti degli oggetti di archiviazione. La memoria per questa matrice viene allocata da Windows Media Gestione dispositivi. Al termine dell'accesso a questa matrice, la memoria deve essere liberata usando CoTaskMemFree.

[out] pnRightsCount

Puntatore al numero di strutture WMDMRIGHTS nella matrice ppRights .

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

I diritti oggetto descrivono le autorizzazioni di utilizzo per il contenuto multimediale digitale. Ad esempio, la struttura WMDMRIGHTS può contenere informazioni relative al numero di volte in cui è possibile riprodurre un file e a chi può riprodurre.

Il recupero dei diritti da un file con licenza può talvolta essere una richiesta lunga; questa funzione consente l'esecuzione asincrona di una richiesta di diritti.

Il provider di contenuto sicuro può generare notifiche di evento sul callback pIProgressCallback oltre alle notifiche di stato. Esempi di tali eventi includono l'acquisizione di un orologio sicuro, l'inizializzazione di DRM e così via. Questi eventi sono descritti in IWMDMProgress3::P rogress3.

Questo metodo è identico a IWMDMStorage::GetRights, ad eccezione dello stato di avanzamento e non fornisce un MAC per la verifica dei parametri.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia IWMDMStorage4

Condividi tramite