IGPMMigrationTable::UpdateDestination method (gpmgmt.h)

Updates the destination field of an entry in a migration table. You can specify the destination option and the destination.

Syntax

HRESULT UpdateDestination(
  [in]           BSTR         bstrSource,
  [in, optional] VARIANT      *pvarDestination,
  [out]          IGPMMapEntry **ppEntry
);

Parameters

[in] bstrSource

The source field of the migration table which is to be updated.

[in, optional] pvarDestination

A pointer to a VARIANT structure. You can use the DestinationOptions: opDestinationSameAsSource, opDestinationNone, or opDestinationByRelativeName by passing in a pvarDestination with a vt member of VT_I4. To explicitly pass in the destination, pass in a pvarDestination with a vt member of VT_BSTR, and this will set the DestinationOption to opDestinationSet. If you pass in null, UpdateDestination uses the default value for the destination option, opDestinationSameAsSource.

[out] ppEntry

The updated entry.

Return value

C++

Returns S_OK if successful. Returns a failure code if an error occurs.

JScript

Returns a reference to a GPMMapEntry object.

VB

Returns a reference to a GPMMapEntry object.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header gpmgmt.h
DLL Gpmgmt.dll

See also

IGPMMigrationTable