Returns whether an object is safe for initialization or scripting, as specified.
Syntax
HRESULT SetInterfaceSafetyOptions(
REFIID riid,
DWORD dwOptionSetMask,
DWORD dwEnabledOptions
);
Parameters
- riid
-
[in] An iInterface identifier for the object to be made safe.
- dwOptionSetMask
-
[in] A mask representing the options to be validated.
- dwEnabledOptions
-
[in] A DWORD representing all the options currently enabled for the interface identified by riid. This can be one or more of the following values.
INTERFACESAFE_FOR_UNTRUSTED_CALLER- Indicates that the caller of the interface identified by riid might be untrusted.
INTERFACESAFE_FOR_UNTRUSTED_DATA- Indicates that the data passed into the interface identified by riid might be untrusted.
INTERFACE_USES_DISPEX- Indicates that the caller of the interface identified by riid knows to use IDispatchEx.
INTERFACE_USES_SECURITY_MANAGER- Indicates that the data passed into the interface identified by riid knows to use IInternetHostSecurityManager.
Return Value
Returns one of the following values.
| S_OK | The object is safe for loading. |
| E_NOINTERFACE | The riid parameter specifies an interface that is unknown to the object. |
| E_FAIL | The dwOptionSetMask parameter specifies an option that is not supported by the object. |
Remarks
Typically, a control client calls this method prior to loading a control to determine whether the control is safe for scripting or initialization. If this method returns E_FAIL, its client displays the user interface for the user to confirm whether the action should be allowed.
See Also
IObjectSafety::GetInterfaceSafetyOptions