Функция NtQueryInformationProcess (winternl.h)

[NtQueryInformationProcess может быть изменено или недоступно в будущих версиях Windows. Приложения должны использовать альтернативные функции, перечисленные в этом разделе.]

Извлекает сведения об указанном процессе.

Синтаксис

__kernel_entry NTSTATUS NtQueryInformationProcess(
  [in]            HANDLE           ProcessHandle,
  [in]            PROCESSINFOCLASS ProcessInformationClass,
  [out]           PVOID            ProcessInformation,
  [in]            ULONG            ProcessInformationLength,
  [out, optional] PULONG           ReturnLength
);

Параметры

[in] ProcessHandle

Дескриптор процесса, для которого требуется получить сведения.

[in] ProcessInformationClass

Тип получаемых сведений о процессе. Этот параметр может быть одним из следующих значений из перечисления PROCESSINFOCLASS .

[out] ProcessInformation

Указатель на буфер, предоставленный вызывающим приложением, в которое функция записывает запрошенные сведения. Размер записываемой информации зависит от типа данных параметра ProcessInformationClass :

PROCESS_BASIC_INFORMATION

Если параметр ProcessInformationClass имеет значение ProcessBasicInformation, буфер, на который указывает параметр ProcessInformation , должен быть достаточно большим, чтобы сохранить одну PROCESS_BASIC_INFORMATION структуру со следующим макетом:

typedef struct _PROCESS_BASIC_INFORMATION {
    NTSTATUS ExitStatus;
    PPEB PebBaseAddress;
    ULONG_PTR AffinityMask;
    KPRIORITY BasePriority;
    ULONG_PTR UniqueProcessId;
    ULONG_PTR InheritedFromUniqueProcessId;
} PROCESS_BASIC_INFORMATION;

ULONG_PTR

Если параметр ProcessInformationClass является ProcessWow64Information, буфер, на который указывает параметр ProcessInformation , должен быть достаточно большим, чтобы сохранить ULONG_PTR. Если это значение ненулевое, процесс выполняется в среде WOW64. В противном случае процесс не выполняется в среде WOW64.

Используйте функцию IsWow64Process2 , чтобы определить, выполняется ли процесс в среде WOW64.

UNICODE_STRING

Если параметр ProcessInformationClass имеет ProcessImageFileName, буфер, на который указывает параметр ProcessInformation , должен быть достаточно большим, чтобы содержать структуру UNICODE_STRING , а также саму строку. Строка, хранящуюся в элементе буфера , — это имя файла изображения.

Если буфер слишком мал, функция завершается ошибкой с кодом ошибки STATUS_INFO_LENGTH_MISMATCH, а параметр ReturnLength имеет требуемый размер буфера.

[in] ProcessInformationLength

Размер буфера, на который указывает параметр ProcessInformation , в байтах.

[out, optional] ReturnLength

Указатель на переменную, в которой функция возвращает размер запрошенной информации. Если функция была успешно выполнена, это размер сведений, записанных в буфер, на который указывает параметр ProcessInformation (если буфер был слишком мал, это минимальный размер буфера, необходимый для успешного получения информации).

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

Функция возвращает код успешного выполнения или ошибки NTSTATUS.

Формы и значение кодов ошибок NTSTATUS перечислены в файле заголовка Ntstatus.h, доступном в DDK. Дополнительные сведения см. в разделе об ошибках ведения журнала .

Замечания

Функция NtQueryInformationProcess и структуры, возвращаемые им, являются внутренними в операционной системе и могут быть изменены с одного выпуска Windows на другой. Чтобы обеспечить совместимость приложения, лучше использовать общедоступные функции, упомянутые в описании параметра ProcessInformationClass .

Если вы используете NtQueryInformationProcess, обратитесь к функции через динамическое связывание во время выполнения. Это дает коду возможность правильно реагировать, если функция была изменена или удалена из операционной системы. Однако изменения подписи могут быть недоступны для обнаружения.

Эта функция не имеет связанной библиотеки импорта. Для динамической связи с Ntdll.dllнеобходимо использовать функции LoadLibrary и GetProcAddress .

Требования

См. также

CheckRemoteDebuggerPresent

GetProcessId

IsDebuggerPresent

IsWow64Process

IsWow64Process2