NetScheduleJobGetInfo 函式 (lmat.h)

[NetScheduleJobGetInfo 已不再可供 Windows 8 使用。 請改用 工作排程器 2.0 介面。

]

NetScheduleJobGetInfo函式會擷取指定電腦上排入佇列的特定工作相關資訊。 此函式需要啟動排程服務。

語法

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

參數

[in, optional] Servername

常數位符串的指標，指定要執行函式之遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null，則會使用本機電腦。

[in] JobId

值，指出要擷取資訊之作業的識別碼。

[out] PointerToBuffer

緩衝區的指標，接收描述指定之作業 的AT_INFO 結構。 此緩衝區是由系統所配置，而且必須使用 NetApiBufferFree 函式釋放。 如需詳細資訊，請參閱 網路管理功能緩衝區 和 網路管理功能緩衝區長度。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的清單，請參閱 系統錯誤碼。

備註

通常只有列舉排程工作之電腦上的本機 Administrators 群組成員才能成功執行此函式。 如果 Servername 參數所指向字串中所傳遞的伺服器名稱是遠端伺服器，則只有伺服器上的本機 Administrators 群組成員可以成功執行此函式。

例如，如果下列登錄值具有最小有效位集 (，0x00000001) ，則屬於伺服器操作員群組的使用者也可以順利執行此函式。

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

需求

另請參閱

AT_INFO

NetScheduleJobAdd

NetScheduleJobDel

NetScheduleJobEnum

網路管理功能

網路管理概觀

排程函式