IMFHttpDownloadRequest::AddHeader method (mfidl.h)

Invoked by Microsoft Media Foundation to add a single HTTP header to a HTTP request. Microsoft Media Foundation will invoke this method once for each header that shall be included in the HTTP request, before it invokes the BeginSendRequest method.

Syntax

HRESULT AddHeader(
  [in] LPCWSTR szHeader
);

Parameters

[in] szHeader

Contains a single HTTP request header, for example, “Accept: /”. The string does not include the carriage return or line feed characters.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
Successfully added the header to the list of headers to be sent with the request.
E_OUTOFMEMORY
There is insufficient memory to complete the operation.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1703 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header mfidl.h
Library Mfplat.lib; Mfplat.dll

See also

IMFHttpDownloadRequest