다음을 통해 공유

ITaskService::Connect 메서드(taskschd.h)

  • 아티클

원격 컴퓨터에 연결하고 이 인터페이스의 모든 후속 호출을 원격 세션과 연결합니다. serverName 매개 변수가 비어 있으면 이 메서드는 로컬 컴퓨터에서 실행됩니다. 사용자가 지정되지 않은 경우 현재 토큰이 사용됩니다.

구문

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

매개 변수

[in, optional] serverName

연결하려는 컴퓨터의 이름입니다. serverName 매개 변수가 비어 있으면 이 메서드는 로컬 컴퓨터에서 실행됩니다.

[in, optional] user

컴퓨터에 연결하는 동안 사용되는 사용자 이름입니다. 사용자가 지정되지 않은 경우 현재 토큰이 사용됩니다.

[in, optional] domain

사용자 매개 변수에 지정된 사용자의 도메인입니다.

[in, optional] password

컴퓨터에 연결하는 데 사용되는 암호입니다. 사용자 이름과 암호를 지정하지 않으면 현재 토큰이 사용됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드/값 Description
S_OK
0
 작업이 성공적으로 완료되었습니다.
E_ACCESS_DENIED
0x80070005
 작업 스케줄러 서비스에 연결하기 위해 액세스가 거부되었습니다.
SCHED_E_SERVICE_NOT_RUNNING
0x80041315
 작업 스케줄러 서비스가 실행되고 있지 않습니다.
E_OUTOFMEMORY
0x8007000e
 애플리케이션에 작업을 완료하는 데 충분한 메모리가 없거나 사용자, 암호 또는 도메인 에 null이 하나 이상 있고 null이 아닌 값이 하나 이상 있습니다.
ERROR_BAD_NETPATH
53
 이 오류는 다음과 같은 상황에서 반환됩니다.
  • serverName 매개 변수에 지정된 컴퓨터 이름이 없습니다.
  • Windows Server 2003 또는 Windows XP 컴퓨터에 연결하려고 하는 경우 원격 컴퓨터에 파일 및 프린터 공유 방화벽 예외가 설정되어 있지 않거나 원격 레지스트리 서비스가 실행되고 있지 않습니다.
  • Windows Vista 컴퓨터에 연결하려고 하는 경우 원격 컴퓨터에 원격 예약된 작업 관리 방화벽 예외가 사용하도록 설정되어 있지 않고 파일 및 프린터 공유 방화벽 예외가 활성화되어 있지 않거나 원격 레지스트리 서비스가 실행되고 있지 않습니다.
ERROR_NOT_SUPPORTED
50
 Windows Vista 컴퓨터에서 원격 Windows XP 또는 Windows Server 2003 컴퓨터에 연결할 때 사용자, 암호 또는 도메인 매개 변수를 지정할 수 없습니다.

설명

다른 ITaskService 메서드를 호출하기 전에 ITaskService::Connect 메서드를 호출해야 합니다.

Windows Vista에서 원격 Windows Vista 컴퓨터에 연결하려면 원격 컴퓨터에서 원격 예약된 작업 관리 방화벽 예외를 허용해야 합니다. 이 예외를 허용하려면 시작, 제어판, 보안, Windows 방화벽을 통한 프로그램 허용을 클릭한 다음 원격 예약된 작업 관리 검사 상자를 선택합니다. 그런 다음 Windows 방화벽 설정 대화 상자에서 확인 단추를 클릭합니다.

Windows Vista 컴퓨터에서 원격 Windows XP 또는 Windows Server 2003 컴퓨터에 연결하는 경우 원격 컴퓨터에서 파일 및 프린터 공유 방화벽 예외를 허용해야 합니다. 이 예외를 허용하려면 시작을 클릭하고 제어판Windows 방화벽을 두 번 클릭하고 예외 탭을 선택한 다음 파일 및 프린터 공유 방화벽 예외를 선택합니다. 그런 다음 Windows 방화벽 대화 상자에서 확인 단추를 클릭합니다. 원격 레지스트리 서비스도 원격 컴퓨터에서 실행 중이어야 합니다.

참고ITaskService::Connect 는 현재 컴퓨터에서 원격 작업의 스키마를 지원하지 않는 경우 작업 정의를 읽는 동안 오류 SCHED_E_INVALIDVALUE 반환할 수 있습니다. 현재 컴퓨터에서 지원하는 가장 높은 스키마 버전을 확인하려면 ITaskService::HighestVersion 속성을 검사.
 

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 taskschd.h
라이브러리 Taskschd.lib
DLL Taskschd.dll

추가 정보

ITaskService

ITaskService::HighestVersion