2.2.4.9 LinkMacToViewerReportRedirect

The LinkMacToViewerReportRedirect message is used by the server in response to a LinkViewerToMacOpenFile (section 2.2.4.21) message from the client. It is used to redirect the client to a new location.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

chunkLen

MID

hr

RedirectType

cbLocation

wszLocation (variable)

...

chunkLen (4 bytes): Length of the message in chunks. A chunk is 8 bytes.

MID (4 bytes): Message ID. For this message, the value MUST be 0x00040022.

hr (4 bytes): HRESULT. Result of processing the client request. For HRESULT codes, see [MS-ERREF].

RedirectType (2 bytes): A 16-bit field. It MUST be set to 0x0001 if the server is redirecting the client to a different URL, or set to 0x0002 if the server is requesting that the client use a different proxy server.

0x0001

0x0002

cbLocation (2 bytes): A 16-bit unsigned integer. It MUST be the size of the wszLocation field, in bytes, including the terminating null character.

wszLocation (variable): A variable size array of Unicode characters. MUST include a terminating null Unicode character. If the value of the RedirectType field is 0x0001, then wszLocation MUST be set to a URL. If the value of the RedirectType field is 0x0002, then wszLocation MUST be set to either a URL to a proxy server or to an empty string (that is, consist of only the terminating null character). If wszLocation is an empty string, it means that the client is requested to stop using a proxy server and connect directly to the server that is sending the LinkMacToViewerReportRedirect message.

If wszLocation is set to a URL, it MUST adhere to the URI syntax specified in [RFC3986]. Percent-encoding, as specified in [RFC3986], MUST NOT be used. If the URI does not contain a port component, the client MUST use TCP port 1755. The scheme component of the URI MUST be one of the values in the following table.

Value

Meaning

"mms"

MMS with Data (section 2.2.2) packets sent over UDP.

"mmsu"

MMS with Data (section 2.2.2) packets sent over UDP.

"mmst"

MMS with Data (section 2.2.2) packets sent over TCP.