3.1.4.1 Application Requests the Enumeration of Servers in a Machine Group
The application MUST provide:
MachineGroup - The NetBIOS name of the machine group.
MaxSize - The maximum number of bytes of data to return.
TypeFilter - Uses the "ServerType" flag field (a 32-bit bitmask) to filter servers by type, in response to the NetServerEnum2 request, as specified in [MS-RAP] section 2.5.5.2.1, "RAP NetServerEnum2Request".
If the client has no entry in the BackupBrowserServerTable for the machine group, it MUST attempt to obtain a list of backup browser servers for MachineGroup, as specified in section 3.1.5.1.
If no GetBackupListResponse is received and the maximum number of retries has been sent as, specified in section 3.1.6, for the GetBackupListRequest timer, the client MUST return ERROR_NO_BROWSER_SERVERS_FOUND to the calling application.
If the client is able to populate a list of backup browser servers for MachineGroup in the BackupBrowserServerTable, it MUST then select a backup server at random from the entry in the BackupBrowserServerTable for the machine group requested, and send it a NetServerEnum2 request (as specified in [MS-RAP] section 2.5.5.2) with the following parameters.
|
NetServerEnum2Request field |
Value |
|---|---|
|
InfoLevel |
1 |
|
ReceiveBufferSize |
MaxSize |
|
ServerType |
TypeFilter |
|
Domain |
MachineGroup |
The objective is to enable multiple backup browser servers to effectively handle high browsing loads. If the request fails, the client MUST return the error received in the response to the higher layer. If the request succeeds, the client MUST return the resulting RapOutParams in the NetServerEnum2Response (as specified in [MS-RAP] section 2.5.5.2.2) to the caller.