Fork

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Fork

The Fork function creates a forked copy of the current message with its request URI field set to the supplied URI string.

Syntax

void Fork(
  string uri
);

Parameters

  • Uri
    Specifies the SIP URI to receive the forked message; for example, "sip:someone@example.com:6767".

Remarks

Call this method for each URI you are forking the message to. Before calling this method, BeginFork must be called to initialize the forking operation for this message. The forked messages are sent collectively with a subsequent call to EndFork.

If you are forwarding to only one destination, ProxyRequest should be called instead. A message cannot be forked if it has a strict (fixed) route. Messages with a strict route have the "Route" header present.

An error is generated if Fork is called without a previous open call to BeginFork.

Note

Although the Office Communications Server APIs permit a request to be forked within an already established session, you should not do so. Forking, say, an ACK request (or any other request with route headers) will confuse endpoints that were not already part of the conversation.