ICorProfilerInfo::GetModuleInfo (Método)

Artículo
08/10/2011

Especificado un identificador de módulo, devuelve el nombre de archivo del módulo y el identificador del ensamblado primario del módulo.

HRESULT GetModuleInfo(
    [in]  ModuleID   moduleId,
    [out] LPCBYTE    *ppBaseLoadAddress,
    [in]  ULONG      cchName,
    [out] ULONG      *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR      szName[] ,
    [out] AssemblyID *pAssemblyId);

Parámetros

moduleId
[in] Identificador del módulo para el que se va a recuperar información.
ppBaseLoadAddress
[out] Dirección base en la que se carga el módulo.
cchName
[in] Longitud, en caracteres, del búfer de retorno de szName.
pcchName
[out] Puntero a la longitud total en caracteres del nombre de archivo del módulo que se devuelve.
szName
[out] Búfer de carácter ancho proporcionado por el llamador. Cuando el método devuelve un valor, este búfer contiene el nombre de archivo del módulo.
pAssemblyId
[out] Puntero al identificador del ensamblado primario del módulo.

Comentarios

Para los módulos dinámicos, el parámetro szName es una cadena vacía y la dirección base es 0 (cero).

Aunque se puede llamar al método GetModuleInfo en cuanto exista el identificador del módulo, el identificador del ensamblado primario no estará disponible hasta que el generador de perfiles reciba la devolución de llamada de ICorProfilerCallback::ModuleAttachedToAssembly.

Una vez que vuelva GetModuleInfo, debe comprobar que el búfer szName era lo bastante grande para contener el nombre de archivo completo del módulo. Para ello, compare el valor al que señala pcchName con el valor del parámetro cchName. Si pcchName señala a un valor mayor que cchName, asigne un búfer de szName mayor, actualice cchName con el nuevo tamaño y llame de nuevo a GetModuleInfo.

Otra opción es llamar primero a GetModuleInfo 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 GetModuleInfo.

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