Programming Reference Manual
 
Syntax
 
Value = object.Find( Label[, Labelstring][, StartAfter])
 
Description
Find a header field in the collection.
 
Part
Description
object
Evaluates to a HttpHeaderFields object.
Label
HttpLabelConstants. Specifies the symbolic name for the header label being added. Use httpNull if Value includes the label.
LabelString
Optional String. Specifies the label to find. Use this parameter to find a non-standard label (not available in HttpLabelConstants). When using this parameter, Label should be httpNull.
StartAfter
Optional Long. Indicates the index to start the search after. StartAfter is updated to reflect the index of the header field found.
Value
String. Value containing the value of the requested header field, without the label.
 

Remarks

This method searches the collection for a label. On return, StartAfter is updated to reflect the index of the label found, allowing you to find multiple header fields having the same label.
 
StartAfter cannot be a constant because the method updates its value. Providing a constant value for StartAfter generates a run-time error. Specifying StartAfter with a value of zero starts the search at the beginning of the collection. StartAfter is set to 0 and "" is returned if the item is not found.
 

Error Codes

The Clear method may generate the following error codes (refer to the ErrorConstants topic for a complete list of error codes):
  • ptInvalidParam1
  • ptInvalidParam3
  • ptNoBufferSpace 
 
See Also