IWDTFTarget2::GetInterface method

Returns an action for the target.

Syntax


HRESULT GetInterface(
  [in]            BSTR ProgID,
  [in, optional]  VARIANT MoreTargets,
  [in, optional]  VARIANT MonikerSuffix,
  [out, retval]   IWDTFAction2 **ppInterface
);

Parameters

ProgID [in]

The WDTF ProgID of the requested interface.

MoreTargets [in, optional]

Optional extra arguments that you can use to define additional targets to attach to the returned interface.

This parameter is not currently implemented. Set MoreTargets to a VARIANT that contains VT_EMPTY.

MonikerSuffix [in, optional]

An optional moniker that defines more options about how the interface should be instantiated.

This parameter is not yet implemented. Set MonikerSuffix to a VARIANT that contains VT_EMPTY.

ppInterface [out, retval]

The address of a variable that will receive the action.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The GetInterface method is the most useful method in the WDTF object model. GetInterface enables you to simply locate a target-specific implementation of an action interface without caring about the specifics of the target.

To write a WDTF scenario, you must understand both the syntax and the semantics of the requested action interface.

For more information about the GetInterface method, see Controlling Targets.

For detailed descriptions of the interfaces that WDTF includes, see Action Interfaces.

Requirements

Minimum supported client

Windows XP Professional

Minimum supported server

Windows Server 2008

Namespace

Microsoft.WDTF

Assembly

WDTF.Interop.metadata_dll

Header

WDTF.h

IDL

WDTF.idl

See also

IWDTFTarget2

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft