Metodo IBackgroundCopyJob::TakeOwnership (bits.h)

  • Articolo

Modifica la proprietà del processo all'utente corrente.

Sintassi

HRESULT TakeOwnership();

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito Descrizione
S_OK
 La proprietà del processo è stata modificata correttamente.
BG_E_INVALID_STATE
 Lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.
BG_E_NEW_OWNER_NO_FILE_ACCESS
 Il nuovo proprietario non ha accesso sufficiente ai file temporanei nel computer client. BITS crea i file temporanei usando le autorizzazioni di sicurezza del proprietario.
BG_E_NEW_OWNER_DIFF_MAPPING
 Il mapping dell'unità di rete del proprietario corrente per il file locale è diverso da quello del proprietario precedente.
E_ACCESSDENIED
 L'utente non dispone dei privilegi di amministratore.

Commenti

Per acquisire la proprietà del processo, l'utente deve disporre dei privilegi di amministratore per il client. In Windows Vista l'utente deve essere eseguito in uno stato con privilegi elevati. Dopo aver assunto la proprietà, tutti gli aggiornamenti futuri del processo devono essere eseguiti durante l'esecuzione dell'utente in uno stato con privilegi elevati. Per informazioni dettagliate, vedere Utenti e Connections di rete.

Un amministratore non deve assumere la proprietà del processo di un altro utente per modificarne le proprietà o per aggiungere file al processo. In genere, un amministratore usa il metodo TakeOwnership se l'utente non dispone di autorizzazioni sufficienti per completare il processo o se l'utente non è connesso e l'amministratore deve completare il processo.

Dopo la modifica della proprietà del processo, il processo viene elaborato solo quando il nuovo proprietario è connesso al client. Chiamare il metodo IBackgroundCopyJob::GetOwner per recuperare il SID del nuovo proprietario.

Se l'amministratore annulla il processo dopo aver assunto la proprietà, è possibile che i file siano orfani perché l'amministratore non dispone dell'autorizzazione di scrittura per i file. Ciò può verificarsi se la destinazione del file locale si trova nel profilo roaming dell'utente precedente.

Il metodo TakeOwnership rimuove le credenziali, i certificati, le intestazioni personalizzate e la notifica della riga di comando dal processo, se impostato.

Se il processo specifica la notifica degli eventi, il callback viene eseguito nel contesto dell'utente che ha chiamato il metodo IBackgroundCopyJob::SetNotifyInterface .

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Piattaforma di destinazione Windows
Intestazione bits.h
Libreria Bits.lib
DLL QmgrPrxy.dll

Vedi anche

IBackgroundCopyJob::GetOwner