ICorProfilerInfo::GetAssemblyInfo-Methode

Artikel
08/10/2011

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

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 des 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. Nach dem Beenden 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.

Hinweise

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 hierzu den Wert, auf den pcchName verweist, mit dem Wert des cchName-Parameters. 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.

Sie können auch zunächst GetAssemblyInfo mit einem szName-Puffer der Größe 0 (null) aufrufen, um die richtige Puffergröße zu ermitteln. Anschließend können Sie die Puffergröße auf der Basis des Werts anpassen, der von pcchName zurückgegeben wurde, und GetAssemblyInfo erneut aufrufen.

Weitere Informationen über diese beiden Ansätze finden Sie unter Vom Aufrufer reservierte Puffer.