Função NetScheduleJobDel (lmat.h)

Artigo
03/14/2023

[NetScheduleJobDel não está mais disponível para uso a partir do Windows 8. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0.

]

A função NetScheduleJobDel exclui um intervalo de trabalhos enfileirados para serem executados em um computador. Essa função exige que o serviço de agendamento seja iniciado no computador para o qual a solicitação de exclusão de trabalho está sendo enviada.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   MinJobId,
  [in]           DWORD   MaxJobId
);

Parâmetros

[in, optional] Servername

Um ponteiro para uma cadeia de caracteres constante que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

[in] MinJobId

O identificador mínimo do trabalho. Trabalhos com um identificador de trabalho menor que MinJobId não serão excluídos.

[in] MaxJobId

O identificador máximo do trabalho. Trabalhos com um identificador de trabalho maior que MaxJobId não serão excluídos.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

Normalmente, somente os membros do grupo administradores locais no computador em que o trabalho de agendamento está sendo excluído podem executar essa função com êxito. Se o nome do servidor passado na cadeia de caracteres apontada pelo parâmetro Servername for um servidor remoto, somente os membros do grupo administradores local no servidor poderão executar essa função com êxito.

Se o valor do Registro a seguir tiver o conjunto de bits menos significativo (por exemplo, 0x00000001), os usuários pertencentes ao grupo Operadores de Servidor também poderão executar essa função com êxito.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Chame a função NetScheduleJobEnum para recuperar o identificador de trabalho para um ou mais trabalhos agendados.

A função NetScheduleJobDel exclui todos os trabalhos cujos identificadores de trabalho estão no intervalo MinJobId por meio de MaxJobId.

Para excluir todos os trabalhos agendados no servidor, você pode chamar NetScheduleJobDel especificando MinJobId igual a 0 e MaxJobId igual a – 1. Para excluir um trabalho, especifique o identificador do trabalho para o parâmetro MinJobId e o parâmetro MaxJobId .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmat.h (inclua Lmat.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll