Метод ICLRProfiling::AttachProfiler

  • Статья

Подключает указанный профилировщик к указанному процессу.

Синтаксис

HRESULT AttachProfiler(  
  [in] DWORD dwProfileeProcessID,  
  [in] DWORD dwMillisecondsMax,                     // optional  
  [in] const CLSID * pClsidProfiler,  
  [in] LPCWSTR wszProfilerPath,                     // optional  
  [in] size_is(cbClientData)] void * pvClientData,  // optional  
  [in] UINT cbClientData);                          // optional

Параметры

dwProfileeProcessID
[in] Идентификатор процесса, к которому следует подключить профилировщик. На 64-разрядном компьютере разрядность профилируемого процесса должна соответствовать разрядности инициирующего процесса, вызывающего метод AttachProfiler. Если учетная запись пользователя, в которой вызывается метод AttachProfiler, имеет права администратора, целевым процессом может быть любой процесс в системе. В противном случае целевой процесс должен принадлежать той же учетной записи пользователя.

dwMillisecondsMax
[in] Время в миллисекундах для завершения выполнения AttachProfiler. Инициирующий процесс должен передавать интервал времени, которого заведомо будет достаточно, чтобы конкретный профилировщик завершил свою инициализацию.

pClsidProfiler
[in] Указатель на идентификатор CLSID загружаемого профилировщика. Инициирующий процесс может повторно использовать эту память после возврата метода AttachProfiler.

wszProfilerPath
[in] Полный путь к загружаемому DLL-файлу профилировщика. Эта строка должна содержать не более 260 символов, включая символ конца строки null. Если в параметре wszProfilerPath задана пустая строка или значение null, среда CLR будет пытаться найти местоположение DLL-файла профилировщика путем поиска в реестре CLSID, на который указывает параметр pClsidProfiler.

pvClientData
[in] Указатель на данные, передаваемые профилировщику методом ICorProfilerCallback3::InitializeForAttach . Инициирующий процесс может повторно использовать эту память после возврата метода AttachProfiler. Если параметр pvClientData имеет значение null, параметр cbClientData должен иметь значение 0 (ноль).

cbClientData
[in] Размер в байтах данных, на которые указывает pvClientData.

Возвращаемое значение

Этот метод возвращает следующие значения HRESULT.

HRESULT Описание:
S_OK Указанный профилировщик успешно подключен к целевому процессу.
CORPROF_E_PROFILER_ALREADY_ACTIVE Уже существует активный профилировщик или профилировщик, подключенный к целевому процессу.
CORPROF_E_PROFILER_NOT_ATTACHABLE Указанный профилировщик не поддерживает подключение. Инициирующий процесс может попытаться подключить другой профилировщик.
CORPROF_E_PROFILEE_INCOMPATIBLE_WITH_TRIGGER Не удалось запросить подключение профилировщика, так как версия целевого процесса несовместима с текущим процессом, вызывающим метод AttachProfiler.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) Пользователь инициирующего процесса не имеет доступа к целевому процессу.
HRESULT_FROM_WIN32(ERROR_PRIVILEGE_NOT_HELD) Пользователь инициирующего процесса не имеет привилегий, необходимых для подключения профилировщика к указанному целевому процессу. В журнале событий приложений могут содержаться дополнительные сведения.
CORPROF_E_IPC_FAILED Произошла ошибка при взаимодействии с целевым процессом. Обычно это происходит при завершении работы целевого процесса.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) Целевой процесс не существует, или в нем не запущена среда CLR, которая поддерживает подключение. Это может указывать, что среда CLR была выгружена после вызова метода перечисления среды выполнения.
HRESULT_FROM_WIN32(ERROR_TIMEOUT) Время ожидания истекло, а загрузка профилировщика не началась. Можно повторить операцию подключения. Время ожидания истекает, когда метод завершения в целевом процессе выполняется дольше, чем задано в значении времени ожидания.
E_INVALIDARG Как минимум один из следующих параметров имеет недопустимое значение.
E_FAIL Произошел другой, не указанный сбой.
Другие коды ошибок Если метод ICorProfilerCallback3::InitializeForAttach профилировщика возвращает HRESULT, указывающий на сбой, AttachProfiler возвращает тот же HRESULT. В этом случае E_NOTIMPL преобразуется в CORPROF_E_PROFILER_NOT_ATTACHABLE.

Комментарии

Управление памятью

В соответствии с соглашениями COM объект, вызывающий метод AttachProfiler (например, код триггера, созданный разработчиком профилировщика), отвечает за выделение и освобождение памяти для данных, на которые указывает параметр pvClientData. Когда среда CLR выполняет вызов AttachProfiler, создается копия памяти, на которую указывает pvClientData, которая затем передается в целевой процесс. Когда среда CLR в целевом процессе получает собственную копию блока pvClientData, она передает этот блок в профилировщик с помощью метода InitializeForAttach, а затем освобождает свою копию блока pvClientData в целевом процессе.

Требования

Платформы: см. раздел Требования к системе.

Заголовок: CorProf.idl, CorProf.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: доступно с 4

См. также раздел