Edit

SafeRef function (comsvcs.h)

  • Article

[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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comsvcs.h
Library ComSvcs.lib
DLL ComSvcs.dll

See also

COM+ Contexts and Threading Models

IMTxAS::SafeRef