3.2.5.2.4 NetrJobGetInfo (Opnum 3)

  • Article

The NetrJobGetInfo method MUST return information for a specified ATSvc task. The task identifier MUST be used to locate the task configuration. 

 NET_API_STATUS NetrJobGetInfo(
   [in, string, unique] ATSVC_HANDLE ServerName,
   [in] DWORD JobId,
   [out] LPAT_INFO* ppAtInfo
 );

ServerName: Pointer to a Unicode string that MUST specify the server. The client MUST map this string to an RPC binding handle. The server MUST ignore this parameter. For more information, see [C706] sections 4.3.5 and 5.1.5.2.

JobId: MUST contain a task identifier.

ppAtInfo:  MUST be a pointer to an AT_INFO structure as specified in section 2.3.4.

Return Values: For more information on return codes, see section 2.3.14, or Win32 Error Codes in [MS-ERREF] section 2.1.

In response to this request the server MUST:

  • Return ERROR_ACCESS_DENIED if the caller does not have administrative privileges on the server.

  • Retrieve from the AT task store the AT_ENUM structure of the task specified by the JobId parameter.

  • Allocate an AT_INFO structure, copy the corresponding fields from the AT_ENUM structure, and return the AT_INFO structure's address in the ppAtInfo parameter.

  • MUST return ERROR_SUCCESS if the call was successful.

  • Return ERROR_FILE_NOT_FOUND if the specified task cannot be found.

If any errors are raised during the processing, they are returned. For more information on return codes, see section 2.3.14 and Win32 Error Codes in [MS-ERREF] section 2.1.