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 |
|---|---|
|
A propriedade do trabalho foi alterada com êxito. |
|
O estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. |
|
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. |
|
O mapeamento da unidade de rede do proprietário atual para o arquivo local é diferente do do proprietário anterior. |
|
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 |