Função OpenJobObjectA (winbase.h)

  • Artigo

Abre um objeto de trabalho existente.

Sintaxe

HANDLE OpenJobObjectA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR 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 relação a 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. 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.

Um erro de ERROR_FILE_NOT_FOUND indica que o trabalho especificado em lpName não existe.

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 winbase.h (inclua Windows.h, Jobapi2.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

AssignProcessToJobObject

Objetos de trabalho

Funções de thread e processo