Método IBackgroundCopyJob::TakeOwnership (bits.h)

Altera a propriedade do trabalho para o usuário atual.

Sintaxe

HRESULT TakeOwnership();

Retornar valor

Esse método retorna os seguintes valores HRESULT , bem como outros.

Código de retorno	Descrição
S_OK	A propriedade do trabalho foi alterada com êxito.
BG_E_INVALID_STATE	O estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.
BG_E_NEW_OWNER_NO_FILE_ACCESS	O novo proprietário não tem acesso suficiente aos arquivos temporários no computador cliente. O BITS cria os arquivos temporários usando as permissões de segurança do proprietário.
BG_E_NEW_OWNER_DIFF_MAPPING	O mapeamento da unidade de rede do proprietário atual para o arquivo local é diferente do do proprietário anterior.
E_ACCESSDENIED	O usuário não tem privilégios de administrador.

Comentários

Para assumir a propriedade do trabalho, o usuário deve ter privilégios de administrador no cliente. No Windows Vista, o usuário deve ser executado em um estado elevado. Depois de assumir a propriedade, todas as atualizações futuras do trabalho devem ser feitas enquanto o usuário está em execução em um estado elevado. Para obter detalhes, consulte Usuários e Connections de rede.

Um administrador não precisa assumir a propriedade do trabalho de outro usuário para alterar suas propriedades ou adicionar arquivos ao trabalho. Normalmente, um administrador usa o método TakeOwnership se o usuário não tiver permissão suficiente para concluir o trabalho ou se o usuário não estiver conectado e o administrador precisar que o trabalho seja concluído.

Depois que a propriedade do trabalho for alterada, o trabalho será processado somente quando o novo proprietário estiver conectado ao cliente. Chame o método IBackgroundCopyJob::GetOwner para recuperar o SID do novo proprietário.

Se o administrador cancelar o trabalho depois de assumir a propriedade, é possível que os arquivos fiquem órfãos porque o administrador não tem permissão de gravação nos arquivos. Isso pode ocorrer se o destino do arquivo local estiver no perfil móvel do usuário anterior.

O método TakeOwnership remove credenciais, certificados, cabeçalhos personalizados e notificação de linha de comando do trabalho, se definido.

Se o trabalho especificar notificação de evento, o retorno de chamada será executado no contexto do usuário que chamou o método IBackgroundCopyJob::SetNotifyInterface .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Servidor mínimo com suporte	Windows Server 2003
Plataforma de Destino	Windows
Cabeçalho	bits.h
Biblioteca	Bits.lib
DLL	QmgrPrxy.dll

Confira também

IBackgroundCopyJob::GetOwner