IWMEncAgentLocator::GetAgent

Windows Media Encoder SDK banner art

The GetAgent method creates a WMEncoderAgent object on a remote computer.

Syntax

HRESULT GetAgent(
  BSTR  bstrMachineName,
  IDispatch**  ppDisp
);

Parameters

bstrMachineName

[in]  BSTR containing the name of the remote computer.

ppDisp

[out]  Pointer to an IDispatch pointer to a WMEncoderAgent object.

Return Values

If the method succeeds, it returns S_OK. If it fails, it supports the IErrorInfo interface and returns an HRESULT error code.

Return code Number Description
E_POINTER 0x80004003 The indirect pointer to the WMEncoderAgent object is NULL.

Remarks

The name that you use for the remote computer depends on the network transport used, but universal naming convention (UNC) names such as Remote1, Domain Name System (DNS) names such as Remote1.com, and IP addresses such as 194.222.147.74 are valid.

Requirements

Header: localagent.h

Library: wmencloc.dll

See Also