NetScheduleJobGetInfo 函式 (lmat.h)

發行項
08/24/2023

[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

需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	lmat.h (include Lmat.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll