Funzione OpenJobObjectA (winbase.h)
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 |