IMFHttpDownloadRequest::QueryHeader-Methode (mfidl.h)
Wird von Microsoft Media Foundation aufgerufen, um die Werte der angegebenen HTTP-Header aus der Antwort auf eine zuvor gesendete HTTP- oder HTTPS-Anforderung abzurufen. Media Foundation ruft diese Methode erst auf, nachdem die EndReceiveResponse-Methode erfolgreich aufgerufen wurde.
Syntax
HRESULT QueryHeader(
[in] LPCWSTR szHeaderName,
[in] DWORD dwIndex,
[out] LPWSTR *ppszHeaderValue
);
Parameter
[in] szHeaderName
Der Name des HTTP-Headers, nach dem der Wert abgefragt wird.
[in] dwIndex
Die Indexnummer des angegebenen Headers für den Fall, in dem die Antwort mehrere Header mit demselben Namen enthält. Der Wert 0 gibt an, dass der Wert des ersten Headers mit dem angegebenen Namen angefordert wird, 1 gibt an, dass der zweite Header angefordert wird usw.
[out] ppszHeaderValue
Legen Sie auf den Wert des angeforderten Headers fest, ohne die Wagenrücklauf- oder Zeilenvorschubzeichen. Der Arbeitsspeicher für ppszHeaderValue muss Mit CoTaskMemAlloc zugeordnet werden und wird von Media Foundation mit CoTaskMemFree freigegeben.
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 |
|---|---|
|
Der Wert des angegebenen Headers mit dem angegebenen Index wurde erfolgreich zurückgegeben. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen. |
|
Der ppszHeaderValue-Parameter ist ein ungültiger Zeiger. |
|
Der dwIndex-Parameterwert liegt außerhalb des Bereichs. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mfidl.h |
| Bibliothek | Mfplat.lib; Mfplat.dll |