[#OSSL_HTTP_proxy_connect]
= OSSL_HTTP_proxy_connect
:mrdocs:

Perform an HTTP CONNECT through a proxy on an already‐connected BIO.

== Synopsis

Declared in `<openssl/http.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
OSSL_HTTP_proxy_connect(
    xref:BIO.adoc[BIO]* bio,
    char const* server,
    char const* port,
    char const* proxyuser,
    char const* proxypass,
    int timeout,
    xref:BIO.adoc[BIO]* bio_err,
    char const* prog);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *bio*
| BIO connected to the HTTP proxy; on success becomes a tunnel to `serverport.`
| *server*
| Target hostname to CONNECT to.
| *port*
| Target port (decimal string) or service name.
| *proxyuser*
| Optional proxy username for Basic auth, or NULL.
| *proxypass*
| Optional proxy password for Basic auth, or NULL.
| *timeout*
| Overall timeout in seconds (0 for none / BIO default).
| *bio_err*
| Optional BIO for diagnostic output, or NULL.
| *prog*
| Optional program name prefix for diagnostics, or NULL.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#