3.1.4.1 Processing Server Replies to Method Calls

Upon receiving a reply from the server in response to a method call, the client MUST validate the return code. Return codes from all method calls are HRESULTs. If the HRESULT indicates success, the client can assume that any output parameters are present and valid.

The client MUST release any DCOM interfaces returned by the server when the client no longer has any use for them.

Some FSRM method calls require no prerequisite calls against the server and simply query for information or pass in parameters constructed by the client. The calls listed in the following subsections, however, are made in sequence. In general, the prerequisite call is to an object enumeration method which retrieves information about a specific set of FSRM objects such as directory quotas, file screens, report jobs, property definitions, module definitions, classification rules, or file management jobs. Information returned by the object enumeration method is then used to supply input parameters for subsequent calls. Calls with such prerequisites are grouped by FSRM object type in sections 3.1.4.1.1, 3.1.4.1.2, 3.1.4.1.3, 3.1.4.1.4, 3.1.4.1.5, and 3.1.4.1.6.