2.5.5.8 Directory Change Notification Using SMB

  • Article

This use case supports the Two Applications Communicate via a Shared File use case (section 2.5.3).

Context of Use: To monitor changes in a directory in an SMB share.

Goal: To send a directory change notification, as requested by the Application.

Actors

  • Application

  • File Client

  • SMB File Service

Stakeholders

  • User

Preconditions

  • The client and server computers are configured in a domain.

  • An SMB file share has been created on the file server.

  • The User has successfully opened, and obtained a handle to, a directory on the SMB file share using the procedure described in the Open a File in an SMB File Share use case (section 2.5.5.4). This handle has been used to request a change notification for the directory.

Main Success Scenario

Trigger: The SMB File Service sends a change notification to the file client for the monitored directory.

  1. The File Client receives a change notification for the monitored directory, with an indication of the type of change that occurred in the object store as described in [MS-CIFS] (sections 2.2.7.4 and 3.2.5.40.3), [MS-SMB] (section 2.2.4.8), and [MS-SMB2] (section 2.2.36).

  2. The File Client supplies the results of the operation to the Application.

Post Condition

A directory change notification is sent to the Application.

Extensions

  • If a protocol error code is returned from the SMB File Service, the Application displays an error message corresponding to the error code returned, and the use case aborts.