IMetaDataAssemblyEmit::DefineAssemblyRef-Methode
Erstellt eine AssemblyRef-Struktur, die Metadaten für die Assembly enthält, auf die diese Assembly verweist, und gibt das zugeordnete Metadatentoken zurück.
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
);
Parameter
pbPublicKeyOrToken
[in] Der öffentliche Schlüssel des Herausgebers der Assembly, auf die verwiesen wird. Mit der Hilfsfunktion StrongNameTokenFromAssembly kann der Hash des öffentlichen Schlüssels abgerufen und als dieser Parameter übergeben werden.cbPublicKeyOrToken
[in] Die Größe von pbPublicKeyOrToken in Bytes.szName
[in] Der lesbare Textname der Assembly. Dieser Wert darf 1024 Zeichen nicht übersteigen.pMetaData
[in] Eine ASSEMBLYMETADATA-Instanz, die Version, Plattform und Gebietsschemainformationen für die Assembly enthält, auf die verwiesen wird.pbHashValue
[in] Die der Assembly, auf die verwiesen wird, zugeordneten Hashdaten. Optional.cbHashValue
[in] Die Größe von pbHashValue in Bytes.dwAssemblyRefFlags
[in] Eine bitweise Kombination von AssemblyRefFlags-Werten, die das Verhalten des Ausführungsmoduls beeinflussen.pmdar
[out] Ein Zeiger auf das zurückgegebene AssemblyRef-Metadatentoken.
Hinweise
Eine AssemblyRef-Metadatenstruktur muss für jede Assembly definiert werden, auf die diese Assembly verweist.
Zur Laufzeit werden die Details der Assembly, auf die verwiesen wird, an den Assemblyresolver mit einem Hinweis übergeben, dass sie die Informationen zum Zeitpunkt des Builds ("as built") darstellen. Der Assemblyresolver wendet dann die Richtlinie an.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: Cor.h
Bibliothek: als Ressource in MsCorEE.dll verwendet
.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0