You are here: Start » FIL.NET » Function Reference » System » HTTP » FIL.Http_SendRequest_DELETE_ByteBuffer

FIL.Http_SendRequest_DELETE_ByteBuffer

Sends a DELETE request to server and receives a binary answer.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void Http_SendRequest_DELETE_ByteBuffer
(
	string inUrl,
	IList<string> inHeaders,
	IList<string> inHeadersData,
	IList<string> inFields,
	IList<string> inFieldsData,
	int inTimeout,
	bool inAllowUntrusted,
	NullableRef<string> inCaCertFile,
	INullable<FilNet.ByteBuffer> outAnswer,
	out int outResponseCode
)

Parameters

Name Type Range Default Description
inUrlstringURL of request. Without parameters.
inHeadersSystem.Collections.Generic.IList<string>Request headers to send. They will be automatically encoded.
inHeadersDataSystem.Collections.Generic.IList<string>Request headers to send. They will be automatically encoded.
inFieldsSystem.Collections.Generic.IList<string>Request data to send. It will be automatically encoded.
inFieldsDataSystem.Collections.Generic.IList<string>Request data to send. It will be automatically encoded.
inTimeoutint<0, INF>60Request timeout in seconds. Default value: 60.
inAllowUntrustedboolFalseWhether or not to allow untrusted SSL certificates. Default value: False.
inCaCertFileFilNet.NullableRef<string>File holding one or more certificates to verify the peer with. Default value: ftl::NIL.
outAnswerFilNet.INullable<FilNet.ByteBuffer>Answer as binary byte buffer. This parameter cannot be null.
outResponseCodeintAnswer code. Typically 200 for OK.

Description

Filter sends a DELETE request to the server then waits for the server answer.

When inCaCertFile is set to Auto, certificates installed in the operating system are used, otherwise only certificates from the input file are used.

Examples

Filter executed with parameters:

  • inUrl = http://localhost/test
  • inFields = ["param1", "param2"]
  • inFieldsData = ["1", "2"]

Request sent to the server:

DELETE /test?param1=1&param2=2 HTTP/1.1
Host: localhost
User-Agent: FabImage/1.0
Accept: */*

It is also possible to include custom headers in the request. For this purpose, inHeaders and inHeadersData parameters are used.

Using the following values for these parameters:

  • inHeaders = ["Header1", "Header2"]
  • inHeadersData = ["value1", "value2"]

causes the following headers to be added to the request:

Header1: value1
Header2: value2

Errors

List of possible exceptions:

Error type Description
DomainError Different size of inFields and inFieldsData in Http_SendRequest_DELETE_ByteBuffer.
DomainError Different size of inHeaders and inHeadersData in Http_SendRequest_DELETE_ByteBuffer.
DomainError Empty inUrl in Http_SendRequest_DELETE_ByteBuffer.
DomainError Invalid inUrl in Http_SendRequest_DELETE_ByteBuffer.

Function Overrides

See also