Share via


IObjectSafety::GetInterfaceSafetyOptions

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the safety options supported by an object as well as the safety options that are currently set for that object.

Syntax

HRESULT GetInterfaceSafetyOptions(
  REFIID riid, 
  DWORD* pdwSupportedOptions, 
  DWORD* pdwEnabledOptions 
);

Parameters

  • riid
    [in] Interface identifier for a given object.
  • pdwSupportedOptions
    [out] Address of a DWORD containing options supported for the interface identified by riid.
  • pdwEnabledOptions
    [out] Address of a DWORD containing options currently enabled for the interface identified by riid.

Return Value

Returns S_OK if successful, or E_NOINTERFACE if the riid parameter specifies an interface that is unknown to the object.

Remarks

This method returns a set of bits in the pdwSupportedOptions parameter for each capability that the control knows about, and a set of bits in the pdwEnabledOptions parameter for each capability for which the control is currently safe.

For example, a control might say that it knows about INTERFACESAFE_FOR_UNTRUSTED_DATA and INTERFACESAFE_FOR_UNTRUSTED_CALLER, and that it is currently safe only for INTERFACESAFE_FOR_UNTRUSTED_DATA.

Requirements

Header objsafe.h, objsafe.idl
Library Developer Implemented
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IObjectSafety