Edit

Share via

IMetaDataAssemblyEmit::DefineAssemblyRef Method

  • Article

Creates an AssemblyRef structure containing metadata for the assembly that this assembly references, and returns the associated metadata token.

Syntax

HRESULT DefineAssemblyRef (  
    [in]  void                *pbPublicKeyOrToken,  
    [in]  ULONG               cbPublicKeyOrToken,  
    [in]  LPCWSTR             szName,  
    [in]  ASSEMBLYMETADATA    pMetaData,  
    [in]  void                *pbHashValue,  
    [in]  ULONG               cbHashValue,  
    [in]  DWORD               dwAssemblyRefFlags,  
    [out] mdAssemblyRef       *pmdar  
);

Parameters

pbPublicKeyOrToken
[in] The public key of the publisher of the referenced assembly. The helper function StrongNameTokenFromAssembly can be used to get the hash of the public key to pass as this parameter.

cbPublicKeyOrToken
[in] The size in bytes of pbPublicKeyOrToken.

szName
[in] The human-readable text name of the assembly. This value must not exceed 1024 characters.

pMetaData
[in] An ASSEMBLYMETADATA instance that contains the version, platform and locale information of the referenced assembly.

pbHashValue
[in] The hash data associated with the referenced assembly. Optional.

cbHashValue
[in] The size in bytes of pbHashValue.

dwAssemblyRefFlags
[in] A bitwise combination of CorAssemblyFlags values that influence the behavior of the execution engine.

pmdar
[out] A pointer to the returned AssemblyRef metadata token.

Remarks

One AssemblyRef metadata structure must be defined for each assembly that this assembly references.

At run time, the details of a referenced assembly are passed to the assembly resolver with an indication that they represent the "as built" information. The assembly resolver then applies policy.

Requirements

Platforms: See System Requirements.

Header: Cor.h

Library: Used as a resource in MsCorEE.dll

.NET Framework Versions: Available since 1.0

See also