IPrincipal 인터페이스(taskschd.h)

보안 주체에 대한 보안 자격 증명을 제공합니다. 이러한 보안 자격 증명은 보안 주체와 연결된 작업에 대한 보안 컨텍스트를 정의합니다.

상속

IPrincipal 인터페이스는 IDispatch 인터페이스에서 상속됩니다.

메서드

IPrincipal 인터페이스에는 이러한 메서드가 있습니다.

IPrincipal::get_DisplayName 보안 주체의 이름을 가져오거나 설정합니다. (Get)
IPrincipal::get_GroupId 보안 주체와 연결된 작업을 실행하는 데 필요한 사용자 그룹의 식별자를 가져오거나 설정합니다. (Get)
IPrincipal::get_Id 보안 주체의 식별자를 가져오거나 설정합니다. (Get)
IPrincipal::get_LogonType 보안 주체와 연결된 작업을 실행하는 데 필요한 보안 로그온 메서드를 가져오거나 설정합니다. (Get)
IPrincipal::get_RunLevel 보안 주체와 연결된 작업을 실행하는 데 필요한 권한 수준을 지정하는 데 사용되는 식별자를 가져오거나 설정합니다. (Get)
IPrincipal::get_UserId 보안 주체와 연결된 작업을 실행하는 데 필요한 사용자 식별자를 가져오거나 설정합니다. (Get)
IPrincipal::p ut_DisplayName 보안 주체의 이름을 가져오거나 설정합니다. (Put)
IPrincipal::p ut_GroupId 보안 주체와 연결된 작업을 실행하는 데 필요한 사용자 그룹의 식별자를 가져오거나 설정합니다. (Put)
IPrincipal::p ut_Id 보안 주체의 식별자를 가져오거나 설정합니다. (Put)
IPrincipal::p ut_LogonType 보안 주체와 연결된 작업을 실행하는 데 필요한 보안 로그온 메서드를 가져오거나 설정합니다. (Put)
IPrincipal::p ut_RunLevel 보안 주체와 연결된 작업을 실행하는 데 필요한 권한 수준을 지정하는 데 사용되는 식별자를 가져오거나 설정합니다. (Put)
IPrincipal::p ut_UserId 보안 주체와 연결된 작업을 실행하는 데 필요한 사용자 식별자를 가져오거나 설정합니다. (Put)

설명

계정을 지정할 때는 코드에서 이중 백슬래시를 올바르게 사용하여 도메인 및 사용자 이름을 지정해야 합니다. 예를 들어 DOMAIN\UserName을 사용하여 UserId 속성의 값을 지정합니다.

작업에 대한 XML을 읽거나 쓸 때 보안 주체에 대한 보안 자격 증명은 작업 스케줄러 스키마의 Principal 요소에 지정됩니다.

작업이 at.exe 명령줄 도구를 사용하여 등록되고 이 인터페이스를 사용하여 작업에 대한 정보를 검색하는 경우 LogonType 속성은 0을 반환하고 RunLevel 속성은 0을 반환하고 UserId 속성은 NULL을 반환합니다.

예제

이 인터페이스에 대한 자세한 내용 및 예제 코드는 시간 트리거 예제(C++) 또는 등록 트리거 예제(C++)를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	taskschd.h

추가 정보

ITaskDefinition

ITaskDefinition의 Principal 속성

작업 스케줄러 인터페이스