4.2 Retrieving Properties of File Server Resource Manager Protocol File Screens

File Server Resource Manager Protocol directory file screen objects are retrievable through a method call on the IFsrmFileScreenManager interface (section 3.2.4.2.29). The following describes how a client gets an existing file screen and retrieves its properties:

  1. The client requests the creation of an instance of the File Screen Manager on the local machine by calling CoCreateInstance with the class GUID of the File Screen Manager, requesting an instance of the File Screen Manager on the server.

  2. The server returns a reference to the IFsrmFileScreenManager interface.

  3. The client calls the method IFsrmFileScreenManager::GetFileScreen (section 3.2.4.2.29.4), passing in the path on a volume on the server for which the client wants to get the file screen.

  4. The server returns a reference to the IFsrmFileScreen interface (section 3.2.4.2.27) of the file screen for the specified path back to the client.

  5. The client calls the IFsrmFileScreenBase::FileScreenFlags (get) (section 3.2.4.2.26.3) method.

  6. The server returns the file screen flags for the file screen.

  7. The client calls the IFsrmFileScreenBase::EnumActions (section 3.2.4.2.26.6) method.

  8. The server collects all the actions for the file screen and returns an IFsrmMutableCollection interface (section 3.2.4.2.2) containing the actions for the file screen.

  9. The client can enumerate the actions in the collection by following steps 5 through 15 of section 4.1.

Flow diagram for querying file screen properties

Figure 2: Flow diagram for querying file screen properties