TIdCustomHTTP.Options Method

Retrieves options and capabilities for a server resource.

Pascal

procedure Options(
    AURL: string
); overload;

Parameters

Parameters	Description
AURL	Identifies the resource location for options and capabilities.

Description

Options is a procedure that implements the HTTP 1.1 command verb used to retrieve information about the communication options available for Request and Response resulting from the URI specified in AURL. Options allows the HTTP client to determine the options and/or requirements associated with a resource, or the capabilities of a server, without implying a resource action or initiating a resource retrieval.

When AURL contains the value '*' (Asterisk), the Options Request applies to all resources on the HTTP server. Since server communication options typically depend on the resource, the "*" request is only useful as a "ping" or "no-op" type of Request. For example, this can be used to test a proxy for HTTP/1.1 compliance. When AURL contains a valid server resource, the Request applies only to that target.

Response will contain the ResponseCode 200, and header information that indicates optional features implemented by the server and applicable to the resource.

Options calls the DoRequest method to perform the HTTP transfer for the Request.