3.2.4.2.48.5 NamespaceRoots (put) (Opnum 15)

The NamespaceRoots (put) method sets the namespace roots that the file management job will scan when the file management job is run.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_FILE_MANAGEMENT_JOB | 0x02))] HRESULT NamespaceRoots(
   [in] SAFEARRAY(VARIANT) namespaceRoots
 );

namespaceRoots: Contains the namespace roots that will be scanned when the file management job is run.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80045306

FSRM_E_INVALID_PATH

One of the namespaceRoots parameter paths violates the specification for a valid path. A valid path cannot contain wildcards and must be local.

0x80070057

E_INVALIDARG

This code is returned for the following reasons:

  • The namespaceRoots is empty.

  • One or more of the variants in the namespaceRoots parameter is not a string.

Upon receiving this message, the server MUST validate parameters:

  • Verify that namespaceRoots contains valid local directories.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

 The server MUST set the namespace roots of the file management job object.