Metodo ICorProfilerInfo::GetAssemblyInfo

Articolo
08/11/2011

Accetta l'identificatore di un assembly e restituisce il nome dell'assembly e l'identificatore del relativo modulo del manifesto.

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);

Parametri

assemblyId
[in] Identificatore dell'assembly.
cchName
[in] Lunghezza del parametro szName in caratteri.
pcchName
[out] Puntatore ai caratteri totali del nome dell'assembly.
szName
[out] Buffer per caratteri di tipo "wide" fornito dal chiamante. Una volta completata, la funzione conterrà il nome dell'assembly.
pAppDomainId
[out] Puntatore all'identificatore del dominio dell'applicazione che contiene l'assembly.
pModuleId
[out] Puntatore all'identificatore del modulo del manifesto dell'assembly.

Note

Dopo il completamento del metodo, è necessario verificare che il buffer szName fosse abbastanza grande per contenere il nome completo dell'assembly. A tal fine, confrontare il valore al quale punta pcchName con il valore del parametro cchName. Se pcchName punta a un valore maggiore di cchName, allocare un buffer szName più grande, aggiornare cchName con la nuova dimensione e chiamare nuovamente GetAssemblyInfo.

In alternativa, è possibile chiamare dapprima il metodo GetAssemblyInfo con un buffer szName di lunghezza zero per ottenere la dimensione del buffer corretta. È quindi possibile regolare la dimensione del buffer in base al valore restituito nel parametro pcchName e chiamare il metodo GetAssemblyInfo.

Per ulteriori informazioni su questi due approcci, vedere Buffer allocati dal chiamante.