IGPMMigrationTable::UpdateDestination method

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

Syntax

HRESULT UpdateDestination(
  BSTR         bstrSource,
  VARIANT      *pvarDestination,
  IGPMMapEntry **ppEntry
);

Parameters

bstrSource

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

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.

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

   
Windows version Windows Vista Windows Server 2008
Target Platform Windows
Header gpmgmt.h
DLL Gpmgmt.dll

See Also

IGPMMigrationTable