IMFContentEnabler::GetEnableURL-Methode (mfidl.h)

  • Artikel

Ruft eine URL zum Ausführen einer manuellen Aktion zum Aktivieren von Inhalten ab.

Syntax

HRESULT GetEnableURL(
  [out]     LPWSTR              *ppwszURL,
  [out]     DWORD               *pcchURL,
  [in, out] MF_URL_TRUST_STATUS *pTrustStatus
);

Parameter

[out] ppwszURL

Empfängt einen Zeiger auf einen Puffer, der die URL enthält. Der Aufrufer muss den Speicher für den Puffer freigeben, indem Er CoTaskMemFree aufruft.

[out] pcchURL

Empfängt die Anzahl der in ppwszURL zurückgegebenen Zeichen, einschließlich des abschließenden NULL-Zeichens.

[in, out] pTrustStatus

Empfängt einen Member der MF_URL_TRUST_STATUS-Enumeration , der angibt, ob die URL vertrauenswürdig ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_NOT_AVAILABLE
 Es ist keine URL verfügbar.

Hinweise

Wenn die Aktivierungsaktion durch Navigieren zu einer URL ausgeführt werden kann, gibt diese Methode die URL zurück. Wenn keine solche URL vorhanden ist, gibt die Methode einen Fehlercode zurück.

Der Zweck der URL hängt vom Inhaltsaktivierertyp ab, der durch Aufrufen von IMFContentEnabler::GetEnableType abgerufen wird.

Typ aktivieren Zweck der URL
Individualisierung Nicht zutreffend.
Lizenzerwerb URL zum Abrufen der Lizenz. Rufen Sie IMFContentEnabler::GetEnableData auf, und übermitteln Sie die Daten als HTTP POST-Anforderung an die URL. Um eine Benachrichtigung beim Erwerb der Lizenz zu erhalten, rufen Sie IMFContentEnabler::MonitorEnable auf.
Widerruf URL zu einer Webseite, auf der der Benutzer eine aktualisierte Komponente herunterladen und installieren kann.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

Wiedergeben geschützter Mediendateien

IMFContentEnabler