2.5.5.2 List Shares

  • Article

This use case supports the Access a File in a Workgroup use case (section 2.5.1).

Context of Use: To display a list of file shares when a User has located and selected a file server.

Goal: To list shares on the selected file server.

Actors

  • Application

  • SMB File Service

  • Authentication Service

  • File Client

Stakeholders

  • User

Precondition

  • The User has identified a file server.

  • An SMB File Service is present on the file server, as defined in [MS-SRVS] section 3.1.

Main Success Scenario

Trigger: The Application receives a request from the User to retrieve a list of shares hosted by the file server.

  1. The application directs a file client to establish a communication channel to the SMB file service, as specified in [MS-SRVS] section 2.1.

  2. The SMB file service authenticates the User through the mechanisms specified in [MS-AUTHSOD].

  3. The application directs the file client to contact the SMB file service using NetrShareEnum ([MS-SRVS] section 3.1.4.8) to retrieve the list of shares.

  4. The SMB file service authorizes the User through the procedure specified in [MS-SRVS] section 3.1.4.8, and then performs the action and returns the results to the Application.

Post Condition

Shares on a file server are listed.

Extensions:

  1. If the communication channel cannot be established, or it becomes disconnected, the application can attempt to establish connection multiple times. Ultimately, the use case ends with failure.

  2. If user authentication fails, the use case ends with failure.

  3. If user authorization fails, the use case ends with failure.