Export (0) Print
Expand All

2.2.4.2 LinkMacToViewerReportConnectedEX

The LinkMacToViewerReportConnectedEX message is sent by the server in response to a LinkViewerToMacConnect (section 2.2.4.17) message from the client.


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

playIncarnation

MacToViewerProtocolRevision

ViewerToMacProtocolRevision

blockGroupPlayTime

...

blockGroupBlocks

nMaxOpenFiles

nBlockMaxBytes

maxBitRate

cbServerVersionInfo

cbVersionInfo

cbVersionUrl

cbAuthenPackage

ServerVersionInfo (variable)

...

VersionInfo (variable)

...

VersionUrl (variable)

...

AuthenPackage (variable)

...

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

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

 

hr (4 bytes): The result of processing the client LinkViewerToMacConnect (section 2.2.4.17) message. For HRESULT codes, see [MS-ERREF].

playIncarnation (4 bytes): A 32-bit field that specifies if the server can perform a packet-pair experiment. It MUST be set to one of the following values:

Value Meaning

MMS_DISABLE_PACKET_PAIR
0xf0f0f0ef

The server cannot perform a packet-pair experiment.

MMS_USE_PACKET_PAIR
0xf0f0f0f0

The server can perform a packet-pair experiment.

MacToViewerProtocolRevision (4 bytes): A 32-bit field. It MUST be set to 0x0004000B.

 

ViewerToMacProtocolRevision (4 bytes): A 32-bit field. It MUST be set to 0x0003001C.

 

blockGroupPlayTime (8 bytes): A DOUBLE (floating-point) field. It MUST be set to 1.0.

 

blockGroupBlocks (4 bytes): A 32-bit field. It MUST be set to 0x00000001.

 

nMaxOpenFiles (4 bytes): A 32-bit field. It MUST be set to 0x00000001.

 

nBlockMaxBytes (4 bytes): A 32-bit field. It MUST be set to 0x00008000.

 

maxBitRate (4 bytes): A 32-bit field. It MUST be set to 0x00989680.<5>

 

cbServerVersionInfo (4 bytes): A 32-bit unsigned integer. This field MUST be set to the number of Unicode characters in the ServerVersionInfo field, including the terminating null character.

cbVersionInfo (4 bytes): A 32-bit unsigned integer. This field MUST be set to the number of Unicode characters in the VersionInfo field, including the terminating null character.

cbVersionUrl (4 bytes): A 32-bit unsigned integer. It MUST be set to the number of Unicode characters in the VersionUrl field, including the terminating null character.

cbAuthenPackage (4 bytes): A 32-bit unsigned integer. It MUST be set to the number of Unicode characters in the AuthenPackage field, including the terminating null character.

ServerVersionInfo (variable): A variable-size array of Unicode characters. It MUST be set to the major and minor version numbers of the software product (specified in section 2.2.4.17) that is sending the LinkMacToViewerReportConnectedEX message and MUST adhere to the following Augmented Backus-Naur Form (ABNF) (as specified in [RFC4234]) syntax:

major = 1*2DIGIT
minor = 1*2DIGIT ["." 1*4DIGIT "." 1*4DIGIT]
server-version-info = major "." minor %x0000

VersionInfo (variable): A variable-size array of Unicode characters. If the server wants the client to upgrade to a new version, it SHOULD include a nonzero size VersionInfo field. When the VersionInfo field has a nonzero size, it MUST specify the major and minor version numbers of the client software that the client should upgrade to, and the VersionInfo field MUST adhere to the following ABNF syntax:

major = 1*2DIGIT
minor = 1*2DIGIT ["." 1*4DIGIT "." 1*4DIGIT]
version-info = major "." minor %x0000

VersionUrl (variable): A variable-size array of Unicode characters. If the VersionInfo field has a nonzero size, the VersionUrl field MUST specify the URL from which the client can download a software update of the version specified by the VersionInfo field. The URL MUST adhere to the URI syntax (as specified in [RFC3986]), it MUST be expressed using Unicode characters, and it MUST include a terminating null character.

AuthenPackage (variable): A variable-size array of Unicode characters. If the server supports authentication, and if it sends a LinkMacToViewerSecurityChallenge (section 2.2.4.14) message to this client, it MUST include a nonzero size AuthenPackage field. The AuthenPackage field MUST specify the authentication scheme the server uses, according to the following ABNF syntax:

auth-scheme= ( "BASIC" / "NTLM" ) %x0000

If the server does not support authentication, or if the server knows it will not send a LinkMacToViewerSecurityChallenge (section 2.2.4.14) message to this client, the AuthenPackage field MAY have a 0 size.

 
Show:
© 2014 Microsoft