IMTxAS::SafeRef method

  • Article

[This method was used in MTS and should not be used in COM+. Instead, use the SafeRef function.]

Do not use in COM+. In MTS, this was used by an object to obtain a reference to itself that could be passed outside its context wrapper. With contexts and interception fully integrated into COM+, this is no longer necessary.

Syntax

HRESULT SafeRef(
  [in]          VARIANT vRefIn,
  [out, retval] VARIANT *pvRefOut
);

Parameters

  • vRefIn [in]
    The object reference to be passed.

  • pvRefOut [out, retval]
    A reference to a VARIANT representing the object that is to be passed to another object or client.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Requirements

Minimum supported client

 Windows 2000 Professional [desktop apps only]

Minimum supported server

 Windows 2000 Server [desktop apps only]

See also

COM+ Contexts and Threading Models

IMTxAS

SafeRef