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
S_OK	La propiedad del trabajo se cambió correctamente.
BG_E_INVALID_STATE	El estado del trabajo no puede ser BG_JOB_STATE_CANCELLED ni BG_JOB_STATE_ACKNOWLEDGED.
BG_E_NEW_OWNER_NO_FILE_ACCESS	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.
BG_E_NEW_OWNER_DIFF_MAPPING	La asignación de unidad de red del propietario actual para el archivo local es diferente de la del propietario anterior.
E_ACCESSDENIED	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

Consulte también

IBackgroundCopyJob::GetOwner