IMetaDataAssemblyEmit::DefineAssemblyRef Method
Creates an AssemblyRef structure containing metadata for the assembly that this assembly references, and returns the associated metadata token.
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 Function 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 Structure 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 AssemblyRefFlags Enumeration 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
Platform: Windows 2000, Windows XP, Windows Server 2003 family
Header: Cor.h
Library: Used as a resource in MsCorEE.dll
.NET Framework Version: 2.0, 1.1, 1.0