ICorProfilerInfo::GetAssemblyInfo-Methode

  • Artikel

Akzeptiert eine Assembly-ID und gibt den Namen der Assembly und die ID ihres Manifestmoduls zurück.

Syntax

HRESULT GetAssemblyInfo(  
    [in]  AssemblyID  assemblyId,  
    [in]  ULONG       cchName,  
    [out] ULONG       *pcchName,  
    [out, size_is(cchName), length_is(*pcchName)]  
          WCHAR       szName[] ,  
    [out] AppDomainID *pAppDomainId,  
    [out] ModuleID    *pModuleId);

Parameter

assemblyId
[in] Der Bezeichner der Assembly.

cchName
[in] Die Länge von szName als Anzahl von Zeichen.

pcchName
[out] Ein Zeiger auf die Gesamtzeichenanzahl des Assemblynamens.

szName
[out] Ein vom Aufrufer bereitgestellter Breitzeichenpuffer. Bei Rückgabe der Funktion enthält er den Namen der Assembly.

pAppDomainId
[out] Ein Zeiger auf die ID der Anwendungsdomäne, die die Assembly enthält.

pModuleId
[out] Ein Zeiger auf die ID des Manifestmoduls der Assembly.

Bemerkungen

Nach der Methodenrückgabe müssen Sie überprüfen, ob der szName-Puffer groß genug war, um den vollständigen Namen der Assembly aufzunehmen. Vergleichen Sie zu diesem Zweck den Wert, auf den pcchName verweist, mit dem Wert des Parameters cchName. Wenn pcchName auf einen Wert verweist, der größer als cchName ist, weisen Sie einen größeren szName-Puffer zu, aktualisieren Sie cchName mit der neuen Größe, und rufen Sie GetAssemblyInfo erneut auf.

Alternativ können Sie zuerst GetAssemblyInfo mit einem szName-Puffer der Länge 0 (NULL) aufrufen, um die richtige Puffergröße zu ermitteln. Sie können die Puffergröße dann auf Basis des Werts anpassen, der von pcchName zurückgegeben wurde, und GetAssemblyInfo erneut aufrufen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch