Función NetScheduleJobGetInfo (lmat.h)

Artículo
03/14/2023

[NetScheduleJobGetInfo ya no está disponible para su uso en Windows 8. En su lugar, use las interfaces del Programador de tareas 2.0.

]

La función NetScheduleJobGetInfo recupera información sobre un trabajo determinado en cola en un equipo especificado. Esta función requiere que se inicie el servicio de programación.

Sintaxis

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

Parámetros

[in, optional] Servername

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

[in] JobId

Valor que indica el identificador del trabajo para el que se va a recuperar información.

[out] PointerToBuffer

Puntero al búfer que recibe la estructura AT_INFO que describe el trabajo especificado. El sistema asigna este búfer y debe liberarse mediante la función NetApiBufferFree . Para obtener más información, consulte Búferes de funciones de administración de red y longitudes de búfer de funciones de administración de red.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

Normalmente, solo los miembros del grupo administradores locales en el equipo donde se enumera el trabajo de programación pueden ejecutar correctamente esta función. Si el nombre del servidor pasado en la cadena a la que apunta el parámetro Servername es un servidor remoto, solo los miembros del grupo administradores locales del servidor pueden ejecutar correctamente esta función.

Si el siguiente valor del Registro tiene el bit menos significativo establecido (por ejemplo, 0x00000001), los usuarios que pertenecen al grupo Operadores de servidor también pueden ejecutar correctamente esta función.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmat.h (include Lmat.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll