ICorProfilerInfo::GetAppDomainInfo (Método)

2011-08-10

Acepta un identificador de dominio de aplicación. Devuelve un nombre de dominio de aplicación y el id. del proceso que 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);

Parámetros

appDomainId
[in] Id. del dominio de aplicación.
cchName
[in] Longitud, en caracteres, del búfer de retorno de szName.
pcchName
[out] Puntero a la longitud total del nombre del dominio de aplicación.
szName
[out] Búfer de carácter ancho proporcionado por el llamador. Cuando el método devuelve un resultado, szName contendrá el nombre del dominio de aplicación total o parcial.
pProcessId
[out] Puntero al id. del proceso que contiene el dominio de aplicación.

Comentarios

Después de que este método devuelva un resultado, debe comprobar que el búfer de szName era suficientemente grande para contener el nombre completo del dominio de aplicación. Para ello, compare el valor al que señala pcchName con el valor del parámetro cchName. Si pcchName señala un valor mayor que cchName, asigne un búfer de szName mayor, actualice cchName con el nuevo tamaño superior y llame de nuevo a GetAppDomainInfo.

Otra opción es llamar primero a GetAppDomainInfo con un búfer de szName de longitud cero para obtener el tamaño de búfer correcto. Después, puede establecer el tamaño del búfer en el valor devuelto en pcchName y llamar de nuevo a GetAppDomainInfo.

Para obtener más información sobre estos dos enfoques, vea Búferes asignados por el llamador.