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, für den der Wert abgefragt wird.

[in] dwIndex

Die Indexnummer des angegebenen Headers für den Fall, dass die Antwort mehrere Header mit demselben Namen enthält. Ein Wert von 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 den Wert der angeforderten Kopfzeile fest, nicht einschließlich der Wagenrücklauf- oder Zeilenvorschubzeichen. Der Speicher für ppszHeaderValue muss mit CoTaskMemAlloc zugewiesen werden und wird von Media Foundation mit CoTaskMemFree freigegeben.

Zurückgegebener Wert

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Anforderungen

Siehe auch

IMFHttpDownloadRequest-