Método IBackgroundCopyJob::TakeOwnership (bits.h)
Cambia la propiedad del trabajo al usuario actual.
Sintaxis
HRESULT TakeOwnership();
Valor devuelto
Este método devuelve los siguientes valores HRESULT , así como otros.
| Código devuelto | Descripción |
|---|---|
|
La propiedad del trabajo se cambió correctamente. |
|
El estado del trabajo no puede ser BG_JOB_STATE_CANCELLED ni BG_JOB_STATE_ACKNOWLEDGED. |
|
El nuevo propietario no tiene acceso suficiente a los archivos temporales en el equipo cliente. BITS crea los archivos temporales mediante los permisos de seguridad del propietario. |
|
La asignación de unidad de red del propietario actual para el archivo local es diferente de la del propietario anterior. |
|
El usuario no tiene privilegios de administrador. |
Comentarios
Para tomar posesión del trabajo, el usuario debe tener privilegios de administrador en el cliente. En Windows Vista, el usuario debe ejecutarse en un estado con privilegios elevados. Después de tomar posesión, todas las actualizaciones futuras del trabajo deben realizarse mientras el usuario se ejecuta en un estado elevado. Para más información, consulte Usuarios y Connections de red.
Un administrador no tiene que tomar posesión del trabajo de otro usuario para cambiar sus propiedades ni para agregar archivos al trabajo. Normalmente, un administrador usa el método TakeOwnership si el usuario no tiene permiso suficiente para completar el trabajo o si el usuario no ha iniciado sesión y el administrador necesita que se complete el trabajo.
Después de cambiar la propiedad del trabajo, el trabajo solo se procesa cuando el nuevo propietario ha iniciado sesión en el cliente. Llame al método IBackgroundCopyJob::GetOwner para recuperar el SID del nuevo propietario.
Si el administrador cancela el trabajo después de tomar posesión, es posible que los archivos estén huérfanos porque el administrador no tiene permiso de escritura para los archivos. Esto puede ocurrir si el destino del archivo local está en el perfil móvil del usuario anterior.
El método TakeOwnership quita las credenciales, los certificados, los encabezados personalizados y la notificación de línea de comandos del trabajo, si se establece.
Si el trabajo especifica la notificación de eventos, la devolución de llamada se ejecuta en el contexto del usuario que llamó al método IBackgroundCopyJob::SetNotifyInterface .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| Plataforma de destino | Windows |
| Encabezado | bits.h |
| Library | Bits.lib |
| Archivo DLL | QmgrPrxy.dll |