Share via

IMFHttpDownloadRequest::QueryHeader-Methode (mfidl.h)

  • Artikel

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
S_OK
 Der Wert des angegebenen Headers mit dem angegebenen Index wurde erfolgreich zurückgegeben.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
E_POINTER
 Der ppszHeaderValue-Parameter ist ein ungültiger Zeiger.
MF_E_OUT_OF_RANGE
 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

Weitere Informationen

IMFHttpDownloadRequest