ICLRRuntimeHost::ExecuteInDefaultAppDomain Method

Calls the specified method of the specified type in the specified managed assembly.

HRESULT ExecuteInDefaultAppDomain (
    [in] LPCWSTR pwzAssemblyPath,
    [in] LPCWSTR pwzTypeName, 
    [in] LPCWSTR pwzMethodName,
    [in] LPCWSTR pwzArgument,
    [out] DWORD *pReturnValue
);

Parameters

  • pwzAssemblyPath
    [in] The path to the Assembly that defines the Type whose method is to be invoked.
  • pwzTypeName
    [in] The name of the Type that defines the method to invoke.
  • pwzMethodName
    [in] The name of the method to invoke.
  • pwzArgument
    [in] The string parameter to pass to the method.
  • pReturnValue
    [out] The integer value returned by the invoked method.

Return Value

HRESULT Description

S_OK

ExecuteInDefaultAppDomain returned successfully.

HOST_E_CLRNOTAVAILABLE

The common language runtime (CLR) has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully.

HOST_E_TIMEOUT

The call timed out.

HOST_E_NOT_OWNER

The caller does not own the lock.

HOST_E_ABANDONED

An event was canceled while a blocked thread or fiber was waiting on it.

E_FAIL

An unknown catastrophic failure occurred. If a method returns E_FAIL, the CRL is no longer usable within the process. Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE.

Remarks

The invoked method must have the following signature:

static int pwzMethodName (String pwzArgument)

where pwzMethodName represents the name of the invoked method, and pwzArgument represents the string value passed as a parameter to that method. If the HRESULT value is set to S_OK, pReturnValue is set to the integer value returned by the invoked method. Otherwise, pReturnValue is not set.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 2.0

See Also

Reference

ICLRRuntimeHost Interface

Other Resources

Hosting the Common Language Runtime