IMFContentEnabler::GetEnableURL-Methode (mfidl.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |