struttura WM_GET_LICENedizione Standard_DATA
[La funzionalità associata a questa pagina, Windows Media Format 11 SDK è una funzionalità legacy. È stato sostituito dal lettore di origine e dal writer sink. Lettore di origine e writer sink sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi lettore di origine e sink writer invece di Windows Media Format 11 SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
La struttura WM_GET_LICENedizione Standard_DATA contiene informazioni sulla posizione in cui acquisire una licenza DRM.
Sintassi
typedef struct _WMGetLicenseData {
DWORD dwSize;
HRESULT hr;
WCHAR *wszURL;
WCHAR *wszLocalFilename;
BYTE *pbPostData;
DWORD dwPostDataSize;
} WM_GET_LICENSE_DATA;
Membri
-
dwSize
-
DWORD contenente le dimensioni della struttura WM_GET_LICENedizione Standard_DATA, in byte.
-
Hr
-
Codice restituito HRESULT .
-
wszURL
-
Stringa con terminazione Null a caratteri wide contenente l'URL di acquisizione della licenza. Usare questa stringa e la stringa pbPostData nell'acquisizione di licenze non invisibile all'utente.
-
wszLocalFilename
-
Stringa con terminazione Null a caratteri wide contenente una pagina HTML locale generata dal componente DRM. Quando questa stringa viene caricata in un browser, reindirizza automaticamente la richiesta HTTP all'URL di acquisizione della licenza, insieme ai dati di post necessari. L'uso di questo URL locale è ora deprecato. L'approccio consigliato consiste nell'usare le stringhe wszURL e pbPostData .
-
pbPostData
-
Puntatore a una matrice di byte contenente i dati da registrare nell'URL di acquisizione della licenza. È necessario aggiungere la stringa seguente all'inizio della stringa pbPostData : "nonsilent=1&challenge=". La stringa risultante deve quindi essere aggiunta a wszURL quando si forma la richiesta HTTP.
-
dwPostDataSize
-
DWORD che indica le dimensioni di pbPostData senza la stringa "nonsilent=1&challenge=" a cui fa riferimento pbPostData.
Osservazioni:
Questa struttura compilata viene restituita nel parametro pValue del metodo IWMStatusCallback::OnStatus se WMT_STATUS è uguale a WMT_NO_RIGHTS_EX o WMT_ACQUIRE_LICENedizione Standard. Per gli eventi di WMT_NO_RIGHTS_EX, il membro hr verrà NS_E_LICENedizione Standard_REQUIRED, NS_E_LICENedizione Standard_OUTOFDATE o NS_E_LICENedizione Standard_INCORRECT_RIGHTS. Uno di questi errori indica che è necessario acquisire una nuova licenza passando all'URL nel membro wszURL .
Per gli eventi WMT_ACQUIRE_LICENedizione Standard, il membro hr passerà la macro SUCC edizione Enterprise DED se una licenza è stata acquisita correttamente. Se questo evento viene ricevuto dopo un tentativo di acquisizione invisibile all'utente e hr è uguale a NS_E_DRM_LICENedizione Standard_NOTACQUIRED, indica che solo l'acquisizione non invisibile all'utente è supportata dal server licenze per questa licenza.
L'applicazione di esempio Audioplayer illustra come usare correttamente le informazioni restituite in questa struttura.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Versione |
Windows Media Format 7 SDK o versioni successive dell'SDK |
| Intestazione |
|