IFsrmFileGroupManager::ImportFileGroups method

[This method is supported for compatibility but it's recommended to use the FSRM WMI Classes to manage FSRM. Please see the MSFT_FSRMFileGroup class.]

Imports the specified file groups from an XML string.

Syntax


HRESULT ImportFileGroups(
  [in]   BSTR serializedFileGroups,
  [in]   VARIANT *fileGroupNamesArray,
  [out]  IFsrmCommittableCollection **fileGroups
);

Parameters

serializedFileGroups [in]

An XML string that represents one or more file groups.

fileGroupNamesArray [in]

A VARIANT that contains a SAFEARRAY of the names of the file groups to import. If NULL, the method imports all file groups.

fileGroups [out]

An IFsrmCommittableCollection interface that contains a collection of file groups.

Each item of the collection is a VARIANT of type VT_DISPATCH. Query the pdispVal member of the variant for the IFsrmFileGroupImported interface.

To add the file groups to FSRM, call the IFsrmCommittableCollection::Commit method.

Return value

The method returns the following return values.

Return codeDescription
S_OK

Success

E_INVALIDARG

The fileGroupNamesArray or fileGroups parameter is NULL or the fileGroupNamesArray parameter is not a variant array of BSTRs.

FSRM_E_INVALID_IMPORT_VERSION

The version of the XML used is not consistent with the schema defined for FSRM in Windows Server 2008.

FSRM_E_NOT_FOUND

The requested template is not in the serialized list of file groups.

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Header

FsrmScreen.h

DLL

SrmSvc.dll

CLSID

CLSID_FsrmFileGroupManager is defined as 8f1363f6-656f-4496-9226-13aecbd7718f

IID

IID_IFsrmFileGroupManager is defined as 426677d5-018c-485c-8a51-20b86d00bdc4

See also

IFsrmFileGroupManager
FsrmFileGroupManager
MSFT_FSRMFileGroup

 

 

Show:
© 2014 Microsoft