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 |
|---|---|
|
작업이 성공적으로 완료되었습니다. |
|
작업 스케줄러 서비스에 연결하기 위해 액세스가 거부되었습니다. |
|
작업 스케줄러 서비스가 실행되고 있지 않습니다. |
|
애플리케이션에 작업을 완료하는 데 충분한 메모리가 없거나 사용자, 암호 또는 도메인 에 null이 하나 이상 있고 null이 아닌 값이 하나 이상 있습니다. |
|
이 오류는 다음과 같은 상황에서 반환됩니다.
|
|
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 방화벽 대화 상자에서 확인 단추를 클릭합니다. 원격 레지스트리 서비스도 원격 컴퓨터에서 실행 중이어야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | taskschd.h |
| 라이브러리 | Taskschd.lib |
| DLL | Taskschd.dll |