IBackgroundCopyJob::TakeOwnership 메서드(bits.h)
작업의 소유권을 현재 사용자로 변경합니다.
구문
HRESULT TakeOwnership();
반환 값
이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
작업 소유권이 변경되었습니다. |
|
작업의 상태는 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다. |
|
새 소유자는 클라이언트 컴퓨터의 임시 파일에 대한 액세스 권한이 부족합니다. BITS는 소유자의 보안 권한을 사용하여 임시 파일을 만듭니다. |
|
로컬 파일에 대한 현재 소유자의 네트워크 드라이브 매핑은 이전 소유자의 네트워크 드라이브 매핑과 다릅니다. |
|
사용자에게 관리자 권한이 없습니다. |
설명
작업의 소유권을 가져오려면 사용자에게 클라이언트에 대한 관리자 권한이 있어야 합니다. Windows Vista에서 사용자는 관리자 권한 상태로 실행해야 합니다. 소유권을 가져온 후 사용자가 관리자 권한 상태에서 실행되는 동안 작업에 대한 향후 업데이트를 수행해야 합니다. 자세한 내용은 사용자 및 네트워크 Connections 참조하세요.
관리자는 속성을 변경하거나 작업에 파일을 추가하기 위해 다른 사용자의 작업에 대한 소유권을 가질 필요가 없습니다. 일반적으로 관리자는 사용자가 작업을 완료할 수 있는 충분한 권한이 없거나 사용자가 로그온되지 않았고 관리자가 작업을 완료해야 하는 경우 TakeOwnership 메서드를 사용합니다.
작업의 소유권이 변경된 후에는 새 소유자가 클라이언트에 로그온한 경우에만 작업이 처리됩니다. IBackgroundCopyJob::GetOwner 메서드를 호출하여 새 소유자의 SID를 검색합니다.
관리자가 소유권 을 가져온 후 작업을 취소하는 경우 관리자가 파일에 대한 쓰기 권한이 없으므로 파일이 분리될 수 있습니다. 이 문제는 로컬 파일 대상이 이전 사용자의 로밍 프로필에 있는 경우에 발생할 수 있습니다.
TakeOwnership 메서드는 설정된 경우 작업에서 자격 증명, 인증서, 사용자 지정 헤더 및 명령줄 알림을 제거합니다.
작업 에서 이벤트 알림을 지정하면 IBackgroundCopyJob::SetNotifyInterface 메서드를 호출한 사용자의 컨텍스트에서 콜백이 실행됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP |
| 지원되는 최소 서버 | Windows Server 2003 |
| 대상 플랫폼 | Windows |
| 헤더 | bits.h |
| 라이브러리 | Bits.lib |
| DLL | QmgrPrxy.dll |