Funzione NetScheduleJobGetInfo (lmat.h)

Articolo
03/14/2023

[NetScheduleJobGetInfo non è più disponibile per l'uso a partire da Windows 8. Usare invece le interfacce dell'utilità di pianificazione 2.0.

]

La funzione NetScheduleJobGetInfo recupera informazioni su un determinato processo accodato in un computer specificato. Questa funzione richiede l'avvio del servizio di pianificazione.

Sintassi

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

Parametri

[in, optional] Servername

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

[in] JobId

Valore che indica l'identificatore del processo per il quale recuperare informazioni.

[out] PointerToBuffer

Puntatore al buffer che riceve la struttura AT_INFO che descrive il processo specificato. Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco di codici di errore, vedere Codici di errore di sistema.

Commenti

In genere solo i membri del gruppo Administrators locale nel computer in cui viene enumerato il processo di pianificazione possono eseguire correttamente questa funzione. Se il nome del server passato nella stringa a cui fa riferimento il parametro Nome server è un server remoto, solo i membri del gruppo Administrators locale nel server possono eseguire correttamente questa funzione.

Se il valore del Registro di sistema seguente ha il set di bit meno significativo (ad esempio, 0x00000001), gli utenti appartenenti al gruppo Operatori server possono anche eseguire correttamente questa funzione.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmat.h (include Lmat.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll