FePolSetConfiguration function

Called by the Policy DLL to provide its desired configuration parameters to FESF.

Syntax

DWORD

FePolSetConfiguration(

    _In_  FE_POLICY_CONFIG * Configuration

)

Parameters

Configuration [in]

A pointer to a FE_POLICY_CONFIG structure that has been filled-in by the Policy DLL to reflect its desired configuration.

Return value

If the function succeeds, ERROR_SUCCESS is returned.

If the function fails for any reason, an appropriate error code is returned.  If a pointer to a required function is missing from the FE_POLICY_CONFIG structure, ERROR_INVALID_DATA is returned.

Remarks

Every Policy DLL must call this function from within its PolicyDllInit callback function, to establish the desired configuration and provide pointers to other Policy DLL functions for the FESF Policy Service to call.

Note that the Solution Policy DLL can start to receive callbacks from FESF as soon as this call is made.

Any structures that are passed-in to FePolSetConfiguration may be freed as soon as FePolSetConfiguration returns to the caller.

Examples

For an illustration of how to set up the FE_POLICY_CONFIG structure and calling FePolicySetConfiguration within the Policy DLL's PolicyDllInit callback function, see SampPolicy.cpp in the Sample Solution.

See Also