Metodo ICorProfilerInfo::GetAppDomainInfo

Articolo
08/11/2011

Accetta un ID del dominio dell'applicazione. Restituisce il nome di un domino applicazione e l'ID del processo che lo contiene.

HRESULT GetAppDomainInfo(
    [in]  AppDomainID appDomainId,
    [in]  ULONG       cchName,
    [out] ULONG       *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR       szName[] ,
    [out] ProcessID   *pProcessId);

Parametri

appDomainId
[in] ID del dominio dell'applicazione.
cchName
[in] Lunghezza del buffer di ritorno szName in caratteri
pcchName
[out] Puntatore ai caratteri totali del nome del dominio dell'applicazione.
szName
[out] Buffer per caratteri di tipo "wide" fornito dal chiamante. Una volta completato il metodo, il parametro szName conterrà il nome del dominio dell'applicazione completo o parziale.
pProcessId
[out] Puntatore all'ID del processo che contiene il dominio dell'applicazione.

Note

Dopo il completamento del metodo, è necessario verificare che il buffer szName fosse abbastanza grande da contenere il nome completo del dominio dell'applicazione. 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 GetAppDomainInfo.

In alternativa, è possibile chiamare dapprima il metodo GetAppDomainInfo con un buffer szName di lunghezza zero per ottenere la dimensione del buffer corretta. È quindi possibile impostare la dimensione del buffer sul valore restituito nel parametro pcchName e chiamare nuovamente il metodo GetAppDomainInfo.

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