3.2.4.2.44.6 NeedsExplicitValue (get) (Opnum 35)

The NeedsExplicitValue (get) method retrieves the Needs explicit value property of the classifier module definition and returns S_OK upon successful completion.

 [propget, id(FSRM_PROPERTY(FSRM_DISPID_CLASSIFIER_MODULE_DEFINITION | 0x03))] HRESULT NeedsExplicitValue(
   [out, retval] VARIANT_BOOL* needsExplicitValue
 );

needsExplicitValue: Pointer to a variable that upon completion contains the Boolean indication for the Needs explicit value property of the classifier module definition.

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

Return value/code

Description

0x80070057

E_INVALIDARG

The needsExplicitValue parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that needsExplicitValue is not NULL.

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

The server MUST set needsExplicitValue to the value VARIANT_TRUE if the classifier module definition's Needs explicit value property is true or set needsExplicitValue to the value VARIANT_FALSE if the classifier module definition's Needs explicit value property is false or the server MUST return a nonzero error code.