IFsrmReportScheduler::VerifyNamespaces method

[Starting with Windows Server 2012 this method is not supported; use the MSFT_FSRMScheduledTask WMI class to manage scheduled tasks.]

Verifies that the specified local directory paths that are used as the source for the reports are valid.

Syntax


HRESULT VerifyNamespaces(
  [in]  VARIANT *namespacesSafeArray
);

Parameters

namespacesSafeArray [in]

A VARIANT that contains a SAFEARRAY of local directory paths. Each element of the array is a variant of type VT_BSTR. Use the bstrVal member of the variant to set the path.

Return value

The method returns the following return values.

Return codeDescription
S_OK

Success

E_INVALIDARG

You can get this error code for the following reasons:

  • The namespacesSafeArray parameter is NULL.
  • The array elements are not BSTRs.
  • The path is empty or greater than MAX_PATH.
FSRM_E_PATH_NOT_FOUND

The path was not found.

FSRM_E_INVALID_PATH

The path cannot contain recursive or wildcard literals, for example, "path\..." or "path\*", respectively.

FSRM_E_VOLUME_UNSUPPORTED

The volume must be an NTFS volume.

FSRM_E_FILE_SYSTEM_CORRUPT

The file system is corrupt.

E_ACCESSDENIED

The user does not have access to the path.

 

Remarks

If the paths are valid, you can use them when calling the IFsrmReportScheduler::CreateScheduleTask method.

The paths are valid if:

  • All paths in the array are on NTFS volumes.
  • All paths in the array are on volumes that are online accessible.
  • For clusters, all paths are on volumes that are in the same failover group.

If one of the paths fails to validate, there is no indication of which path failed. To determine which path failed, you need to call this method for each path separately. For clusters, if all paths validate, you need to verify the cluster groups using the cluster APIs.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

End of server support

Windows Server 2008 R2

Header

FsrmReports.h (include FsrmReports.h or FsrmTlb.h)

IDL

FsrmReports.idl

DLL

SrmSvc.dll

CLSID

CLSID_FsrmReportScheduler is defined as ea25f1b8-1b8d-4290-8ee8-e17c12c2fe20

IID

IID_IFsrmReportScheduler is defined as 6879caf9-6617-4484-8719-71c3d8645f94

See also

IFsrmReportScheduler
FsrmReportScheduler

 

 

Show:
© 2014 Microsoft