Metodo IWMDRMSecurity::GetContentEnablersForRevocations

Articolo
06/21/2023

[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita 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 writer sink anziché 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.

Il metodo GetContentEnablersForRevocations recupera le interfacce di abilitazione del contenuto che consentono il rinnovo dei componenti in base ai certificati revocati.

Sintassi

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parametri

rgpbCerts [in]

Matrice di certificati per cui recuperare gli strumenti di abilitazione del contenuto. Il numero di elementi nella matrice deve essere specificato da cCerts.

rgpdwCertSizes [in]

Matrice contenente le dimensioni dei certificati nella matrice rgpbCerts . Il numero di elementi nella matrice deve essere specificato da cCerts.

rgpguidCerts [in]

Matrice contenente i tipi dei certificati nella matrice rgpbCerts . Il numero di elementi nella matrice deve essere specificato da cCerts. Per ogni elemento della matrice, usare uno dei valori seguenti.

Costante GUID	Descrizione
WMDRM_REVOCATIONTYPE_APP	Specifica un certificato dell'applicazione.
WMDRM_REVOCATIONTYPE_DEVICE	Specifica un certificato del dispositivo.
WMDRM_REVOCATIONTYPE_CARDEA	Specifica un certificato DRM Di Windows Media per i dispositivi di rete.

cCerts [in]

Numero di certificati per cui recuperare gli strumenti di abilitazione del contenuto. Si tratta del numero di elementi nella matrice rgpbCerts , nella matrice rgpdwCertSizes e nella matrice rgpguidCerts .

hResultHint [in]

Valore restituito ricevuto dall'operazione non riuscita a causa di un certificato revocato. Se non si chiama in risposta a una chiamata al metodo non riuscito, impostare su S_OK.

prgContentEnablers [out]

Matrice che riceve gli indirizzi delle interfacce IMFContentEnabler appena create. Impostare su NULL per ottenere il numero di abilitazioni del contenuto nel parametro pcContentEnablers .

pcContentEnablers [in, out]

Numero di elementi nella matrice prgContentEnablers . Se prgContentEnablers è NULL, questo valore viene impostato sul numero di enabler di contenuto necessari nell'output.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Se si utilizza l'interfaccia IMFContentEnabler per rinnovare i componenti revocati, è necessario chiarire il processo all'utente. Questo chiarimento deve essere fatto perché il processo di aggiornamento invia informazioni dal computer client a un sito Web Microsoft.

Quando si chiama IMFContentEnabler::AutomaticEnable, l'abilitazione del contenuto avvia il browser predefinito con l'indirizzo del servizio di aggiornamento nel sito Web Microsoft. Un identificatore univoco che identifica il componente revocato viene inviato al servizio di aggiornamento. Il servizio reindirizza quindi il browser a una pagina Web da cui l'utente può essere in grado di scaricare e installare la nuova versione del componente revocato.

Requisiti

Requisito	Valore
Intestazione	Wmdrmsdk.h
Libreria	Wmdrmsdk.lib

Vedi anche

Revoca e rinnovo automatizzati dei componenti
Interfaccia IWMDRMSecurity

Share via