IObjectSafety::GetInterfaceSafetyOptions 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 riid specifies an interface that is unknown to the object.

Remarks

This method returns a set of bits in pdwSupportedOptions for each capability that the control knows about, and a set of bits in pdwEnabledOptions 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 is currently safe for just INTERFACESAFE_FOR_UNTRUSTED_DATA.