Uso de la API de cliente de Servicios de implementación de Windows
En entornos en los que no se puede usar una solución estándar de Servicios de implementación de Windows (WDS) para instalar Windows, la API del cliente WDS permite a los desarrolladores escribir aplicaciones de implementación personalizadas. Las aplicaciones pueden usar esta API para comunicarse con el servidor WDS para obtener información sobre las imágenes del sistema disponibles desde el servidor. Las aplicaciones cliente WDS personalizadas deben cumplir las siguientes directrices.
Instalar el rol WDS en el servidor
- Servicios de implementación de Windows (WDS) es la versión revisada de Servicios de instalación remota (RIS), necesitará el rol de servidor WDS en el servidor para implementar soluciones de cliente WDS personalizadas.
- WDS reemplaza RIS como componente estándar a partir de Windows Server 2008 y Windows Server 2003 por Service Pack 2 (SP2).
- Debe actualizar el servidor RIS a WDS en Windows Server 2003 con Service Pack 1 (SP1). Puede instalar el rol de servidor WDS con el Kit de instalación automatizada (WAIK) de Windows.
Iniciar Windows PE 2.0
Windows PE 2.0 debe iniciarse, si aún no se ha iniciado. El cliente WDS y los archivos DLL auxiliares solo se cargan setup.exe cuando se encuentra en la fase de procesamiento de configuración del entorno de preinstalación de Microsoft Windows (Windows PE 2.0).
- Cuando un equipo nuevo está conectado a la red, la tecnología integrada del entorno de ejecución de arranque previo (PXE) se puede usar para descargar el programa de arranque de red. Para obtener más información sobre el arranque pxe de un equipo para instalar Windows, vea La guía paso a paso de actualización de servicios de implementación de Windows.
- Una imagen de arranque de RAMDISK de Windows PE 2.0 se puede almacenar en . Formato WIM y descargado como parte del proceso de arranque de red. Después, Windows PE se puede cargar y ejecutar directamente desde ese medio.
Abrir una sesión con el servidor WDS
El cliente WDS debe abrir una sesión con un servidor WDS.
- Use la función WdsCliCreateSession para abrir una sesión con un servidor WDS. Esta función toma el nombre o la dirección IP del servidor y recibe la dirección del identificador de la sesión de cliente de WDS.
- Si abrir la sesión con el servidor requerirá autenticar el cliente WDS, la aplicación debe proporcionar la dirección de una estructura de WDS_CLI_CRED que contiene las credenciales de cliente al llamar a la función WdsCliCreateSession . La aplicación puede usar la función WdsCliAuthorizeSession para convertir una sesión anónima en una sesión autenticada.
- Cuando la sesión abierta con la función WdsCliCreateSession ya no es necesaria, la aplicación debe usar la función WdsCliClose para cerrar el identificador y liberar los recursos mantenidos por la sesión.
Enumerar imágenes del sistema en el servidor WDS
El cliente WDS puede usar la API para enumerar las imágenes del sistema en el servidor WDS.
- Use la función WdsCliFindFirstImage para obtener un identificador para la primera imagen e inicializar la enumeración de imágenes en el servidor WDS.
- Use la función WdsCliFindNextImage para incrementar la enumeración iniciada por la función WdsCliFindFirstImage . La función WdsCliFindNextImage obtiene el identificador de la siguiente imagen.
- Use la función WdsCliGetImageIndex para obtener el índice de imagen de la imagen actual. Este valor solo es válido hasta que se vuelvan a usar las funciones WdsCliFindNextImage o WdsCliClose .
- Use la función WdsCliGetEnumerationFlags para obtener marcas informativas sobre el filtrado de imágenes.
Obtención de información sobre imágenes
El cliente WDS puede usar la API para obtener información sobre las imágenes en un servidor WDS. Las siguientes funciones obtienen información sobre la imagen actual. Dado que las funciones WdsCliFindFirstImage y WdsCliFindNextImage cambian el valor del identificador de imagen actual, la aplicación debe almacenar cualquier información que obtenga y necesitará en el futuro antes de llamar a las funciones WdsCliFindFirstImage o WdsCliFindNextImage de nuevo.
- Use la función WdsCliGetImageArchitecture para obtener la arquitectura del procesador de la imagen actual.
- Use la función WdsCliGetImagePath para obtener la ruta de acceso relativa al archivo de imagen que contiene la imagen actual.
- Use la función WdsCliGetImageSize para obtener el tamaño de la imagen.
- Use la función WdsCliGetImageVersion para obtener la versión de la imagen.
- Use la función WdsCliGetImageLanguage para obtener el idioma predeterminado de la imagen actual.
- Use la función WdsCliGetImageLanguages para obtener una matriz de idiomas admitidos por la imagen actual.
- Use WdsCliGetImageLastModifiedTime devuelve la hora de última modificación de la imagen actual.
- Use la función WdsCliGetImageName para obtener el nombre de la imagen actual.
- Use la función WdsCliGetImageDescription para obtener la descripción de la imagen actual.
- Use la función WdsCliGetImageGroup para obtener el nombre del grupo de imágenes de la imagen actual.
- Use la función WdsCliGetImageHalName para obtener el nombre de capa de abstracción de hardware (HAL) de la imagen actual.
Registrar eventos de cliente de WDS
La funcionalidad de registro de la biblioteca cliente de WDS permite enviar eventos de progreso de instalación desde el cliente al servidor WDS.
- Use la función WdsCliInitializeLog para inicializar el registro de la sesión del cliente WDS.
- Use la función WdsCliLog para escribir mensajes de evento en el registro del servidor WDS.
- En Windows Server 2008, el servidor WDS escribe eventos de cliente en un registro de eventos específico de la aplicación que se puede ver a través de eventvwr.exe, así como el registro de seguimiento de depuración. En Windows Server 2003 con el registro de depuración habilitado, el servidor WDS escribirá eventos de cliente en el archivo de registro ubicado en %windir%\tracing\wdsserver.log. El registro de cliente WDS debe estar habilitado en el servidor para capturar estos eventos.
Temas relacionados