Share via

3.2.4.2.23.3 Name (put) (Opnum 13)

  • Article

The Name (put) method sets the name of the file group.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_FILEGROUP | 0x01))] HRESULT Name(
   [in] BSTR name
 );

name: Contains the name for the file group to use. This string MUST NOT contain illegal name characters (section 3.2.4.2). The maximum length of this string MUST be 4,000 characters.

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

Return value/code

Description

0x8004530D

FSRM_E_OUT_OF_RANGE

The content of the name parameter exceeds the maximum length of 4,000 characters.

0x80004003

E_POINTER

The name parameter is NULL.

0x80070057

E_INVALIDARG

The name parameter contains non-valid characters or is NULL. The following are considered invalid characters: comma (,), single quote ('), double quote ("), vertical bar (|).

The server MUST use name as the File Group.Name for the file group or return a nonzero error code.