2.2.4.21 LinkViewerToMacOpenFile

The LinkViewerToMacOpenFile message is sent by the client to specify the name of the resource on the server that is to be streamed.


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

playIncarnation

spare

token

cbtoken

fileName (variable)

...

tokenData (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 0x00030005.

playIncarnation (4 bytes): A 32-bit field. It MUST be set to a value in the range 0x00000001 to 0x000000FE, inclusive.

spare (4 bytes): A 32-bit field. SHOULD be set to 0x00000000. It MUST be ignored by the receiver.<19>

token (4 bytes): A 32-bit unsigned integer. If the LinkViewerToMacOpenFile message contains a nonzero size tokenData field, the token field MUST specify the offset to the start of the tokenData field, counted in bytes from the start of the fileName field. If the size of the tokenData field is zero, the value of the token field MUST be 0x00000000.

Example: If the fileName field is abc.asf, and the size of the tokenData field is nonzero, the value of the token field must be 0x00000010.

cbtoken (4 bytes): A 32-bit unsigned integer. It MUST be the size, in bytes, of the tokenData field.

fileName (variable): A variable size array of Unicode characters specifying the path component of the URL of the content. See definition of path as specified in [RFC3986] section 3.3. Percent-encoding (as specified in [RFC3986] section 2.1) MUST NOT be used on the characters in the path. The fileName field SHOULD include a terminating null Unicode character, unless the value of the cbtoken field is greater than 0, in which case the fileName field MUST include a terminating null Unicode character.

Example: media/mediastream.asf

tokenData (variable): A variable size array of bytes. It MUST contain authentication data of the size given by the cbtoken field. Thus, if the cbtoken field is 0x00000000, the tokenData field is not included in the message.

If the authentication data is for the Basic authentication scheme, as specified in [RFC2617], the authentication data MUST be the user name and password, according to the syntax for basic-credentials, as specified in [RFC2617]. The basic-credentials authentication data MUST be stored in the tokenData field as a null-terminated ASCII string.

If the authentication data is for the NTLM authentication scheme (as specified in [MS-NLMP]), the tokenData consists of either an NTLM_AUTH structure (as defined in section 2.2.4.14.1) or an NTLM response token (as defined in [MS-NLMP] section 2.2.1.1).