Share via

2.1.2.1.2 OUT Channel Request

  • Article

The OUT channel request is an HTTP request [RFC2616]. The header fields of that HTTP request are as follows:

Method:  MUST be set to the "RPC_OUT_DATA" string.

Accept:  Clients SHOULD set this to "application/rpc" string literal. Outbound proxies MUST ignore this header field.

Cache-Control:  Clients MUST set this to "no-cache". Outbound proxies MUST ignore this header field.

Connection:  Clients MUST set this to "Keep-Alive". Outbound proxies MUST ignore this header field.

Content-Length: MUST be set to 76 for nonreplacement OUT channels and set to 120 for replacement OUT channels.

Host:  Clients MUST set this to the server name of the outbound proxy ([RFC2616] section 14.23, Host). Outbound proxies SHOULD ignore this header field.

Pragma Directives:

  • Clients MUST add a "No-cache" pragma directive as specified in [RFC2616] section 14.32. Outbound proxies MUST ignore this directive.

  • Optional pragma directive that, if present, MUST be defined to have the format "Pragma:MinConnTimeout=T", where T MUST be a decimal string representation of the minimum connection time-out, in seconds, to be used for this OUT channel. The time-out MUST be in the inclusive range of 120 to 14,400 seconds.

  • Optional pragma directive that, if present, MUST be defined to have the format "Pragma:ResourceTypeUuid=R", where R MUST be a UUID formatted as a string ([C706] Appendix A, Universal Unique Identifier). This pragma specifies the Resource Type UUID for this channel. For more details on Resource Type UUID, see section 3.2.3.1.5.

  • Optional pragma directive that, if present, MUST be defined to have the format "Pragma:SessionId=S", where S MUST be a UUID formatted as a string ([C706] Appendix A, Universal Unique Identifier). This pragma specifies the session ID for this channel.

Protocol:  Clients SHOULD set this to 1.0. Outbound proxies SHOULD ignore this header field.

URL: The server name and port are encoded in this field. For information on how the encoding is done, see section 2.2.2 of this specification.

User-Agent:  Clients SHOULD set this to the "MSRPC" string literal. Outbound proxies SHOULD ignore this header field.

Message Body: For the definition of how the message body of an OUT channel request MUST be created, see section 2.1.2.1.8 of this specification.