ICorRuntimeHost::CreateEvidence Method

Gets an interface pointer of type System.Security.Principal.IIdentity, which allows the host to create security evidence to pass to the CreateDomain or CreateDomainEx method.

Syntax

HRESULT CreateEvidence (  
    [out] IUnknown** pEvidence  
);  

Parameters

pEvidence
[out] A interface pointer to an System.Security.Principal.IIdentity instance used to create security evidence. This pointer is typed IUnknown, so callers should typically call QueryInterface on this interface to obtain a pointer to an System.Security.Principal.IIdentity.

Return Value

HRESULT Description
S_OK The operation was successful.
S_FALSE The operation failed to complete.
E_FAIL An unknown, catastrophic failure occurred. If a method returns E_FAIL, the common language runtime (CLR) is no longer usable in the process. Subsequent calls to any hosting APIs return HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE The 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.

Remarks

This method returns an empty collection that cannot be populated from native code. You should use the Evidence method instead.

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 1.0, 1.1

See also