Metodo IBackgroundCopyJob::TakeOwnership (bits.h)
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 |
|---|---|
|
La proprietà del processo è stata modificata correttamente. |
|
Lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED. |
|
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. |
|
Il mapping dell'unità di rete del proprietario corrente per il file locale è diverso da quello del proprietario precedente. |
|
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 |