ICLRRuntimeHost::ExecuteInDefaultAppDomain Method

ExecuteInDefaultAppDomain Method

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework General Reference

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: See .NET Framework System Requirements.

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Reference

ICLRRuntimeHost Interface

Other Resources

Hosting the Common Language Runtime