다음을 통해 공유


IBackgroundCopyJob::TakeOwnership 메서드(bits.h)

작업의 소유권을 현재 사용자로 변경합니다.

구문

HRESULT TakeOwnership();

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드 설명
S_OK
작업 소유권이 변경되었습니다.
BG_E_INVALID_STATE
작업의 상태는 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다.
BG_E_NEW_OWNER_NO_FILE_ACCESS
새 소유자는 클라이언트 컴퓨터의 임시 파일에 대한 액세스 권한이 부족합니다. BITS는 소유자의 보안 권한을 사용하여 임시 파일을 만듭니다.
BG_E_NEW_OWNER_DIFF_MAPPING
로컬 파일에 대한 현재 소유자의 네트워크 드라이브 매핑은 이전 소유자의 네트워크 드라이브 매핑과 다릅니다.
E_ACCESSDENIED
사용자에게 관리자 권한이 없습니다.

설명

작업의 소유권을 가져오려면 사용자에게 클라이언트에 대한 관리자 권한이 있어야 합니다. Windows Vista에서 사용자는 관리자 권한 상태로 실행해야 합니다. 소유권을 가져온 후 사용자가 관리자 권한 상태에서 실행되는 동안 작업에 대한 향후 업데이트를 수행해야 합니다. 자세한 내용은 사용자 및 네트워크 Connections 참조하세요.

관리자는 속성을 변경하거나 작업에 파일을 추가하기 위해 다른 사용자의 작업에 대한 소유권을 가질 필요가 없습니다. 일반적으로 관리자는 사용자가 작업을 완료할 수 있는 충분한 권한이 없거나 사용자가 로그온되지 않았고 관리자가 작업을 완료해야 하는 경우 TakeOwnership 메서드를 사용합니다.

작업의 소유권이 변경된 후에는 새 소유자가 클라이언트에 로그온한 경우에만 작업이 처리됩니다. IBackgroundCopyJob::GetOwner 메서드를 호출하여 새 소유자의 SID를 검색합니다.

관리자가 소유권 가져온 후 작업을 취소하는 경우 관리자가 파일에 대한 쓰기 권한이 없으므로 파일이 분리될 수 있습니다. 이 문제는 로컬 파일 대상이 이전 사용자의 로밍 프로필에 있는 경우에 발생할 수 있습니다.

TakeOwnership 메서드는 설정된 경우 작업에서 자격 증명, 인증서, 사용자 지정 헤더명령줄 알림을 제거합니다.

작업 에서 이벤트 알림을 지정하면 IBackgroundCopyJob::SetNotifyInterface 메서드를 호출한 사용자의 컨텍스트에서 콜백이 실행됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP
지원되는 최소 서버 Windows Server 2003
대상 플랫폼 Windows
헤더 bits.h
라이브러리 Bits.lib
DLL QmgrPrxy.dll

추가 정보

IBackgroundCopyJob::GetOwner