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.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 can 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.