差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- wxk:vc:taskschd [2025/03/03 18:18] – 创建 wxk
+++ wxk:vc:taskschd [2025/03/03 18:24] (当前版本) – wxk
@@ 行 1: / 行 1: @@
 ======windows计划任务管理======
+此 C++ 示例演示如何创建在用户登录时计划执行记事本的任务。 该任务包含一个登录触发器，该触发器指定要启动的任务的起始边界，以及一个指定用户的用户标识符。 该任务使用管理员组注册为安全上下文以运行任务。
+以下过程介绍如何在用户登录时计划任务以启动可执行文件。
+计划用户登录时启动记事本
+  - 初始化 COM 并设置常规 COM 安全性。
+  - 创建 ITaskService 对象。
+  - 此对象允许在指定文件夹中创建任务。
+  - 获取任务文件夹以在其中创建任务。
+  - 使用 ITaskService：：GetFolder 方法获取文件夹，使用 ITaskService：：NewTask 方法创建 ITaskDefinition 对象。
+  - 使用 ITaskDefinition 对象定义有关任务的信息，例如任务的注册信息。
+  - 使用 ITaskDefinition 的 RegistrationInfo 属性 和 ITaskDefinition 接口的其他属性定义任务信息。
+  - 使用 ITaskDefinition 的 Triggers 属性 创建登录触发器，以访问任务的 ITriggerCollection 接口。
+  - 使用 ITriggerCollection：：Create 方法指定要创建登录触发器。 可以设置触发器的起始边界和 UserId 属性，以便在启动边界后用户登录时计划执行任务的操作。
+  - 使用 ITaskDefinition 的 Actions 属性 访问任务的 IActionCollection 接口，为任务创建一个操作。 使用 IActionCollection：：Create 方法指定要创建的操作类型。 此示例使用 IExecAction 对象，该对象表示执行命令行操作的操作。
+  - 使用 ITaskFolder：：RegisterTaskDefinition 方法注册任务。
+以下 C++ 示例演示如何在用户登录时计划任务以执行记事本。
+<code cpp>
+/**********************************************************************
+ This sample schedules a task to start notepad.exe when a user logs on.
+**********************************************************************/
+#define _WIN32_DCOM
+#include <windows.h>
+#include <iostream>
+#include <stdio.h>
+#include <comdef.h>
+//  Include the task header file.
+#include <taskschd.h>
+#pragma comment(lib, "taskschd.lib")
+#pragma comment(lib, "comsupp.lib")
+using namespace std;
+int __cdecl wmain()
+{
+    //  ------------------------------------------------------
+    //  Initialize COM.
+    HRESULT hr = CoInitializeEx(NULL, COINIT_MULTITHREADED);
+    if( FAILED(hr) )
+    {
+        printf("\nCoInitializeEx failed: %x", hr );
+        return 1;
+    }
+    //  Set general COM security levels.
+    hr = CoInitializeSecurity(
+        NULL,
+        -1,
+        NULL,
+        NULL,
+        RPC_C_AUTHN_LEVEL_PKT_PRIVACY,
+        RPC_C_IMP_LEVEL_IMPERSONATE,
+        NULL,
+,
+        NULL);
+    if( FAILED(hr) )
+    {
+        printf("\nCoInitializeSecurity failed: %x", hr );
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Create a name for the task.
+    LPCWSTR wszTaskName = L"Logon Trigger Test Task";
+    //  Get the windows directory and set the path to notepad.exe.
+    wstring wstrExecutablePath = _wgetenv( L"WINDIR");
+    wstrExecutablePath += L"\\SYSTEM32\\NOTEPAD.EXE";
+    //  ------------------------------------------------------
+    //  Create an instance of the Task Service.
+    ITaskService *pService = NULL;
+    hr = CoCreateInstance( CLSID_TaskScheduler,
+                           NULL,
+                           CLSCTX_INPROC_SERVER,
+                           IID_ITaskService,
+                           (void**)&pService );
+    if (FAILED(hr))
+    {
+          printf("Failed to create an instance of ITaskService: %x", hr);
+          CoUninitialize();
+          return 1;
+    }
+    //  Connect to the task service.
+    hr = pService->Connect(_variant_t(), _variant_t(),
+        _variant_t(), _variant_t());
+    if( FAILED(hr) )
+    {
+        printf("ITaskService::Connect failed: %x", hr );
+        pService->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Get the pointer to the root task folder.  This folder will hold the
+    //  new task that is registered.
+    ITaskFolder *pRootFolder = NULL;
+    hr = pService->GetFolder( _bstr_t( L"\\") , &pRootFolder );
+    if( FAILED(hr) )
+    {
+        printf("Cannot get Root Folder pointer: %x", hr );
+        pService->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  If the same task exists, remove it.
+    pRootFolder->DeleteTask( _bstr_t( wszTaskName), 0  );
+    //  Create the task builder object to create the task.
+    ITaskDefinition *pTask = NULL;
+    hr = pService->NewTask( 0, &pTask );
+    pService->Release();  // COM clean up.  Pointer is no longer used.
+    if (FAILED(hr))
+    {
+        printf("Failed to create a task definition: %x", hr);
+        pRootFolder->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Get the registration info for setting the identification.
+    IRegistrationInfo *pRegInfo= NULL;
+    hr = pTask->get_RegistrationInfo( &pRegInfo );
+    if( FAILED(hr) )
+    {
+        printf("\nCannot get identification pointer: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    hr = pRegInfo->put_Author(L"Author Name");
+    pRegInfo->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nCannot put identification info: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Create the settings for the task
+    ITaskSettings *pSettings = NULL;
+    hr = pTask->get_Settings( &pSettings );
+    if( FAILED(hr) )
+    {
+        printf("\nCannot get settings pointer: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  Set setting values for the task.
+    hr = pSettings->put_StartWhenAvailable(VARIANT_TRUE);
+    pSettings->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nCannot put setting info: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Get the trigger collection to insert the logon trigger.
+    ITriggerCollection *pTriggerCollection = NULL;
+    hr = pTask->get_Triggers( &pTriggerCollection );
+    if( FAILED(hr) )
+    {
+        printf("\nCannot get trigger collection: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  Add the logon trigger to the task.
+    ITrigger *pTrigger = NULL;
+    hr = pTriggerCollection->Create( TASK_TRIGGER_LOGON, &pTrigger );
+    pTriggerCollection->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nCannot create the trigger: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    ILogonTrigger *pLogonTrigger = NULL;
+    hr = pTrigger->QueryInterface(
+            IID_ILogonTrigger, (void**) &pLogonTrigger );
+    pTrigger->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nQueryInterface call failed for ILogonTrigger: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    hr = pLogonTrigger->put_Id( _bstr_t( L"Trigger1" ) );
+    if( FAILED(hr) )
+       printf("\nCannot put the trigger ID: %x", hr);
+    //  Set the task to start at a certain time. The time
+    //  format should be YYYY-MM-DDTHH:MM:SS(+-)(timezone).
+    //  For example, the start boundary below
+    //  is January 1st 2005 at 12:05
+    hr = pLogonTrigger->put_StartBoundary( _bstr_t(L"2005-01-01T12:05:00") );
+    if( FAILED(hr) )
+       printf("\nCannot put the start boundary: %x", hr);
+    hr = pLogonTrigger->put_EndBoundary( _bstr_t(L"2015-05-02T08:00:00") );
+    if( FAILED(hr) )
+       printf("\nCannot put the end boundary: %x", hr);
+    //  Define the user.  The task will execute when the user logs on.
+    //  The specified user must be a user on this computer.
+    hr = pLogonTrigger->put_UserId( _bstr_t( L"DOMAIN\\UserName" ) );
+    pLogonTrigger->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nCannot add user ID to logon trigger: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Add an Action to the task. This task will execute notepad.exe.
+    IActionCollection *pActionCollection = NULL;
+    //  Get the task action collection pointer.
+    hr = pTask->get_Actions( &pActionCollection );
+    if( FAILED(hr) )
+    {
+        printf("\nCannot get Task collection pointer: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  Create the action, specifying that it is an executable action.
+    IAction *pAction = NULL;
+    hr = pActionCollection->Create( TASK_ACTION_EXEC, &pAction );
+    pActionCollection->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nCannot create the action: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    IExecAction *pExecAction = NULL;
+    //  QI for the executable task pointer.
+    hr = pAction->QueryInterface(
+        IID_IExecAction, (void**) &pExecAction );
+    pAction->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nQueryInterface call failed for IExecAction: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  Set the path of the executable to notepad.exe.
+    hr = pExecAction->put_Path( _bstr_t( wstrExecutablePath.c_str() ) );
+    pExecAction->Release();
+    if( FAILED(hr) )
+    {
+        printf("\nCannot set path of executable: %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    //  ------------------------------------------------------
+    //  Save the task in the root folder.
+    IRegisteredTask *pRegisteredTask = NULL;
+    hr = pRootFolder->RegisterTaskDefinition(
+            _bstr_t( wszTaskName ),
+            pTask,
+            TASK_CREATE_OR_UPDATE,
+            _variant_t(L"S-1-5-32-544"),
+            _variant_t(),
+            TASK_LOGON_GROUP,
+            _variant_t(L""),
+            &pRegisteredTask);
+    if( FAILED(hr) )
+    {
+        printf("\nError saving the Task : %x", hr );
+        pRootFolder->Release();
+        pTask->Release();
+        CoUninitialize();
+        return 1;
+    }
+    printf("\n Success! Task successfully registered. " );
+    // Clean up
+    pRootFolder->Release();
+    pTask->Release();
+    pRegisteredTask->Release();
+    CoUninitialize();
+    return 0;
+}
+</code>