Metodo IMDSPStorage::GetRights (mswmdm.h)

Il metodo GetRights recupera le informazioni sui diritti per un oggetto .

Sintassi

HRESULT GetRights(
  [out]     PWMDMRIGHTS *ppRights,
  [out]     UINT        *pnRightsCount,
  [in, out] BYTE [8]    abMac
);

Parametri

[out] ppRights

Puntatore a una matrice di strutture WMDMRIGHTS che contengono le informazioni sui diritti dell'oggetto di archiviazione. Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[out] pnRightsCount

Puntatore al numero di strutture WMDMRIGHTS nella matrice ppRights . Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[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

Il metodo restituisce un valore 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

Commenti

I diritti degli oggetti descrivono le autorizzazioni di utilizzo per il contenuto multimediale. Ad esempio, la struttura WMDMRIGHTS può contenere informazioni sul numero di volte in cui un file può essere riprodotto e chi può riprodurlo.

La matrice ppRights viene allocata da questo metodo e deve essere liberata dall'applicazione usando CoTaskMemFree, una funzione Win32 standard.

È facoltativo. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

Requisiti

Vedi anche

Interfaccia IMDSPStorage

WMDMRIGHTS