2.2.4 GetBackupListRequest Browser Frame
The GetBackupListRequest frame is sent by a browser client to the local master browser server for a machine group to retrieve the identities of backup browser servers. Its response is a GetBackupListResponse frame, as specified in section 2.2.5. For more information about the use of the GetBackupListRequest frame, see section 3.1.5.1.
To get the list of backup browser servers for <machine group> from the local master browser server for that domain, the GetBackupListRequest browser frame MUST be sent to the master browser server with the NetBIOS unique name <machine group>[0x1D] and mailslot \MAILSLOT\BROWSE.
To get the list of backup browser servers for <domain> from the domain master browser server for that domain, the GetBackupListRequest browser frame MUST be sent to the domain master browser server with the NetBIOS unique name <domain>[0x1B] and mailslot \MAILSLOT\BROWSE.
The format of the GetBackupListRequest frame, which is 6 bytes in length, MUST be as follows.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
0x09 |
RequestedCount |
Token |
|||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
0x09 (1 byte): The 8-bit opcode that identifies this structure as a GetBackupListRequest frame. This opcode MUST have a value of 0x09.
RequestedCount (1 byte): An 8-bit integer that specifies the number of backup servers that the client is requesting.<15>
Token (4 bytes): MUST be a 32-bit value. This field has significance only to the client issuing the browser frame. The local master browser server MUST return this token unmodified in the corresponding GetBackupListResponse response message. The client MUST use this to distinguish replies to multiple outstanding GetBackupListRequests.<16>