Funzione OpenJobObjectA (winbase.h)

  • Articolo

Apre un oggetto processo esistente.

Sintassi

HANDLE OpenJobObjectA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

Parametri

[in] dwDesiredAccess

Accesso all'oggetto processo. Questo parametro può essere uno o più dei diritti di accesso all'oggetto processo. Questo diritto di accesso viene controllato in base a qualsiasi descrittore di sicurezza per l'oggetto.

[in] bInheritHandle

Se questo valore è TRUE, i processi creati da questo processo erediteranno l'handle. In caso contrario, i processi non ereditano questo handle.

[in] lpName

Nome del processo da aprire. I confronti dei nomi fanno distinzione tra maiuscole e minuscole.

Questa funzione può aprire oggetti in uno spazio dei nomi privato. Per altre informazioni, vedere Spazi dei nomi degli oggetti.

Servizi terminal: Il nome può avere un prefisso "Global" o "Local" per aprire in modo esplicito l'oggetto nello spazio dei nomi globale o sessione. Il resto del nome può contenere qualsiasi carattere ad eccezione del carattere barra rovesciata (\). Per altre informazioni, vedere Spazi dei nomi degli oggetti kernel.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il processo. L'handle fornisce l'accesso richiesto al processo.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Un errore di ERROR_FILE_NOT_FOUND indica che il processo specificato in lpName non esiste.

Commenti

Per associare un processo a un processo, usare la funzione AssignProcessToJobObject .

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h, Jobapi2.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

AssignProcessToJobObject

Oggetti processo

Funzioni di processi e thread