Función NetRequestProvisioningPackageInstall (lmjoin.h)
La función NetRequestProvisioningPackageInstall se ejecuta localmente en un equipo para modificar una imagen de sistema operativo Windows montada en un volumen. El registro se carga desde la imagen y los datos del paquete de aprovisionamiento se escriben donde se pueden recuperar durante la fase de finalización de una operación de unión a un dominio sin conexión.
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetRequestProvisioningPackageInstall(
[in] BYTE *pPackageBinData,
[in] DWORD dwPackageBinDataSize,
[in] DWORD dwProvisionOptions,
[in] LPCWSTR lpWindowsPath,
PVOID pvReserved
);
Parámetros
[in] pPackageBinData
Puntero a un búfer necesario para inicializar el registro de una imagen de sistema operativo Windows para procesar el cambio de estado local final durante la fase de finalización de la operación de unión a un dominio sin conexión.
La función NetCreateProvisioningPackage devuelve el blob binario opaco de metadatos serializados pasados en el parámetro pPackageBinData.
[in] dwPackageBinDataSize
Tamaño, en bytes, del búfer al que apunta el parámetro pPackageBinData .
Este parámetro no debe ser NULL.
[in] dwProvisionOptions
Conjunto de marcas de bits que definen opciones para esta función. Este parámetro usa uno o varios de los siguientes valores definidos en el archivo de encabezado Lmjoin.h .
[in] lpWindowsPath
Puntero a una cadena de caracteres terminada en NULL que especifica la ruta de acceso a una imagen del sistema operativo Windows en la que se encuentran los subárboles del Registro. Esta imagen debe estar sin conexión y no arrancar actualmente a menos que el parámetro dwProvisionOptions contenga NETSETUP_PROVISION_ONLINE_CALLER, en cuyo caso, se permite el directorio del sistema operativo que se ejecuta localmente.
Esta ruta de acceso podría ser una ruta UNC en un servidor remoto.
pvReserved
Reservado para uso futuro.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NERR_Success.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error de administración de red.
| Código devuelto | Descripción |
|---|---|
|
No se encontró la información de finalización de la combinación sin conexión. |
|
La información de finalización de la combinación sin conexión era incorrecta. |
|
No se puede crear información de unión sin conexión. Asegúrese de que tiene acceso a la ubicación de la ruta de acceso y los permisos especificados para modificar su contenido. Es posible que se ejecute como administrador con privilegios elevados. |
|
La información de unión al dominio que se guardaba estaba incompleta o incorrecta. |
|
La operación de unión sin conexión se completó correctamente, pero se necesita un reinicio. |
|
No había ninguna operación de unión sin conexión pendiente. |
|
No se pueden establecer uno o varios valores de nombre de dominio o equipo solicitados en el equipo local. |
|
No se pudo comprobar el nombre de host del equipo actual con el valor guardado en la información de finalización de la combinación. |
|
No se puede cargar el subárbol del Registro sin conexión especificado. Asegúrese de que tiene acceso a la ubicación de la ruta de acceso y los permisos especificados para modificar su contenido. Es posible que se ejecute como administrador con privilegios elevados. |
|
No se han cumplido los requisitos mínimos de seguridad de sesión para esta operación. |
|
No se admite la versión del blob de aprovisionamiento de cuentas de equipo. |
Comentarios
La función NetRequestProvisioningPackageInstall se admite en Windows 8 para las operaciones de unión a un dominio sin conexión. Para Windows 7, use NetRequestOfflineDomainJoin.
El escenario de unión a un dominio sin conexión usa dos funciones:
- NetCreateProvisioningPackage es una función de aprovisionamiento a la que se llama primero para realizar las operaciones de red necesarias para crear y configurar el objeto de equipo en Active Directory. La salida de NetCreateProvisioningPackage es un paquete que se usa para el paso siguiente.
- Se llama a NetRequestProvisioningPackageInstall, una función de inicialización de imagen, para insertar la salida de la función de aprovisionamiento NetCreateProvisioningPackage en una imagen del sistema operativo Windows para su uso durante la instalación.
La función NetCreateProvisioningPackage creará o reutilizará la cuenta de equipo en el dominio, recopilará todos los metadatos necesarios y los devolverá en un paquete. La operación de solicitud de unión a un dominio sin conexión puede consumir el paquete proporcionando toda la entrada necesaria para completar la unión al dominio durante el primer arranque sin ninguna operación de red (solo actualizaciones de estado local).
Nota de seguridad: El paquete creado por la función NetCreateProvisioningPackage contiene datos muy confidenciales. Debe tratarse de forma tan segura como una contraseña de texto no cifrado. El paquete contiene la contraseña de la cuenta de equipo y otra información sobre el dominio, incluido el nombre de dominio, el nombre de un controlador de dominio y el identificador de seguridad (SID) del dominio. Si el paquete se transporta físicamente o a través de la red, se debe tener cuidado para transportarlo de forma segura. El diseño no hace ninguna disposición para proteger estos datos. Este problema existe actualmente con archivos de respuesta de instalación desatendida que pueden llevar varios secretos, incluidas las contraseñas de usuario de dominio. El autor de la llamada debe proteger el paquete. Las soluciones a este problema son variadas. Por ejemplo, se podría usar una clave intercambiada previamente para cifrar una sesión entre el consumidor y la entidad de aprovisionamiento, lo que permite una transferencia segura del paquete.
El paquete devuelto en el parámetro pPackageBinData por la función NetCreateProvisioningPackage tiene versiones para permitir escenarios de interoperabilidad y capacidad de servicio entre diferentes versiones de Windows (como unir un cliente, aprovisionar una máquina y usar un controlador de dominio). Actualmente, el escenario de combinación sin conexión no limita la duración del paquete devuelto por la función NetCreateProvisioningPackage .
Todas las fases del proceso de aprovisionamiento se anexan a un archivo NetSetup.log en el equipo local. El proceso de aprovisionamiento puede incluir hasta tres equipos diferentes: el equipo donde se crea el paquete de aprovisionamiento, el equipo que solicita la instalación del paquete y el equipo donde está instalado el paquete. Habrá información del archivo NetSetup.log almacenada en los tres equipos según la operación realizada. Revisar el contenido de estos archivos es el medio más común para solucionar errores de aprovisionamiento en línea y sin conexión. Las operaciones de aprovisionamiento realizadas por los administradores se registran en el archivo NetSetup.log en %WINDIR%\Debug. Las operaciones de aprovisionamiento realizadas por los no administradores se registran en el archivo NetSetup.log en la carpeta %USERPROFILE%\Debug .
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | lmjoin.h (include Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |
Consulte también
NetProvisionComputerAccount