Função NetScheduleJobGetInfo (lmat.h)

Artigo
08/24/2023

[NetScheduleJobGetInfo 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 NetScheduleJobGetInfo recupera informações sobre um trabalho específico enfileirado em um computador especificado. Essa função exige que o serviço de agendamento seja iniciado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

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] JobId

Um valor que indica o identificador do trabalho para o qual recuperar informações.

[out] PointerToBuffer

Um ponteiro para o buffer que recebe a estrutura AT_INFO que descreve o trabalho especificado. Esse buffer é alocado pelo sistema e deve ser liberado usando a função NetApiBufferFree . Para obter mais informações, consulte Buffers de função de gerenciamento de rede e Comprimentos de buffer de função de gerenciamento de rede.

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 local Administradores no computador em que o trabalho de agendamento está sendo enumerado 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 local Administradores 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

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 (include Lmat.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll