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

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

Sintaxe

HRESULT TakeOwnership();

Valor de retorno

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

Observações

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 Conexões 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 a notificação de evento, o retorno de chamada será executado no contexto do usuário que chamou o método IBackgroundCopyJob::SetNotifyInterface .

Requirements

Consulte também

IBackgroundCopyJob::GetOwner