3.2.4.2.15.6 MatchesSourceTemplate (get) (Opnum 26)

The MatchesSourceTemplate (get) method returns whether this quota object's properties match the template it was derived from or not.

 [propget, id(FSRM_PROPERTY(FSRM_DISPID_QUOTA_OBJECT | 0x05))] HRESULT MatchesSourceTemplate(
   [out, retval] VARIANT_BOOL* matches
 );

matches: Pointer to a variable that upon completion contains information regarding whether or not this quota object's properties match the template it was derived from.

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

Return value/code

Description

0x80070057

E_INVALIDARG

The matches parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

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

The server MUST do one of the following or return a nonzero error code.

  • If the quota object was not derived from a template, the server MUST return S_FALSE.

  • If all the quota object's properties match those of the quota template it was derived from, the server MUST set matches to VARIANT_TRUE.

  • If all the quota object's properties do not match those of the quota template it was derived from, the server MUST set matches to VARIANT_FALSE.