描述
添加，更改或删除HTTP请求标头。
C / C ++语法
HRESULT SetRequestHeader( BSTR bstrHeader, BSTR bstrValue ); |
PowerBASIC 语法
METHOD SetRequestHeader ( _ BYVAL bstrHeader AS WSTRING, _ BYVAL bstrValue AS WSTRING _ ) |
参数
bstrHeader
[in]类型为BSTR的值，指定要设置的标题名称，例如“depth”。此参数不应包含冒号，并且必须是HTTP标头的实际文本。
bstrValue
[in]类型为BSTR的值，用于指定标题的值，例如“无限远”。
返回值
此方法不返回值。
OBJRESULT
如果成功返回S_OK，否则返回错误值。
备注
标头会跨重定向传输。这可能会造成安全漏洞。为避免在发生重定向时传送标题，请在重定向发生时使用WINHTTP_STATUS_CALLBACK回调来更正特定的标题。
SetRequestHeader方法使呼叫应用程序在发送请求之前添加或删除HTTP请求头。标题名称在bstrHeader中给出，标题标记或值在bstrValue中给出。要添加标题，请提供标题名称和值。如果这个名称已经存在另一个标题，它将被替换。要删除标题，请将bstrHeader设置为要删除的标题名称，并将bstrValue设置为NULL。
使用此方法添加的请求标头的名称和值将被验证。标题必须形成良好。有关有效的HTTP标头的更多信息，请参阅RFC 2616.如果使用无效头，则会发生错误，并且不添加头。