Metodo IWMDRMSecurity::GetContentEnablersFromHashes

[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita da Lettore di origine e 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 GetContentEnablersFromHashes recupera le interfacce di abilitazione del contenuto che consentono il rinnovo dei componenti in base ai certificati hash.

Sintassi

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parametri

rgpbCertHashes [in]

Matrice di hash del certificato per ottenere gli abilitanti del contenuto per.

cCerts [in]

Numero di certificati per recuperare gli abilitanti del contenuto per. Si tratta del numero di elementi nella matrice rgpbCertHashes .

hResultHint [in]

Valore restituito ricevuto dall'operazione che 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 FMContentEnabler appena create. Impostare su NULL per ottenere il numero di abilitatori di contenuto nel parametro pcContentEnablers .

pcContentEnablers [in, out]

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

Valore restituito

Il metodo restituisce un 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 usa l'interfaccia FMContentEnabler per rinnovare i componenti revocati, è necessario chiarire il processo all'utente. Questa spiegazione deve essere effettuata perché il processo di aggiornamento invia informazioni dal computer client a un sito Web Microsoft.

Quando si chiama FMContentEnabler::AutomaticEnable, il content enabler avvia il browser predefinito con l'indirizzo del servizio di aggiornamento nel sito Web Microsoft. 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

Interfaccia IWMDRMSecurity