Compartilhar via


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