Função OpenJobObjectW (jobapi2.h)
Abre um objeto de trabalho existente.
Sintaxe
HANDLE OpenJobObjectW(
[in] DWORD dwDesiredAccess,
[in] BOOL bInheritHandle,
[in] LPCWSTR lpName
);
Parâmetros
[in] dwDesiredAccess
O acesso ao objeto de trabalho. Esse parâmetro pode ser um ou mais dos direitos de acesso ao objeto de trabalho. Esse direito de acesso é verificado em qualquer descritor de segurança para o objeto .
[in] bInheritHandle
Se esse valor for TRUE, os processos criados por esse processo herdarão o identificador. Caso contrário, os processos não herdam esse identificador.
[in] lpName
O nome do trabalho a ser aberto. As comparações de nomes diferenciam maiúsculas de minúsculas.
Essa função pode abrir objetos em um namespace privado. Para obter mais informações, consulte Namespaces de objeto.
Serviços de Terminal: O nome pode ter um prefixo "Global\" ou "Local\" para abrir explicitamente o objeto no namespace global ou de sessão. O restante do nome pode conter qualquer caractere, exceto o caractere de barra invertida (\). Para obter mais informações, consulte Namespaces de objeto kernel.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador para o trabalho. O identificador fornece o acesso solicitado ao trabalho.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Para associar um processo a um trabalho, use a função AssignProcessToJobObject .
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | jobapi2.h (inclua Windows.h, Jobapi2.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |