SafeRef function (comsvcs.h)

[Do not use SafeRef in COM+. This function was used by objects in MTS to obtain a reference to itself. With COM+, this is no longer necessary.]

Syntax

void * SafeRef(
  [in] REFIID   rid,
  [in] IUnknown *pUnk
);

Parameters

[in] rid

A reference to the IID of the interface that the current object wants to pass to another object or client.

[in] pUnk

A reference to the IUnknown interface on the current object.

Return value

If the function succeeds, the return value is a pointer to the specified interface that can be passed outside the current object's context. Otherwise, the return value is NULL.

Requirements

See also

COM+ Contexts and Threading Models

IMTxAS::SafeRef