Функция GetProcessId (processthreadsapi.h)

Статья
08/25/2023

Извлекает идентификатор указанного процесса.

Синтаксис

DWORD GetProcessId(
  [in] HANDLE Process
);

Параметры

[in] Process

Дескриптор процесса. Дескриптор должен иметь право доступа PROCESS_QUERY_INFORMATION или PROCESS_QUERY_LIMITED_INFORMATION. Дополнительные сведения см. в разделе Управление правами на доступ и безопасность процесса.

Windows Server 2003 и Windows XP: Дескриптор должен иметь право доступа PROCESS_QUERY_INFORMATION.

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

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

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Пока процесс не завершится, его идентификатор процесса однозначно идентифицирует его в системе. Дополнительные сведения о правах доступа см. в разделе Управление безопасностью и правами доступа.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 1 (SP1) [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	processthreadsapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также