Uso da API de cliente de Serviços de Implantação do Windows
Em ambientes em que uma solução padrão dos Serviços de Implantação do Windows (WDS) não pode ser usada para instalar o Windows, a API do cliente WDS permite que os desenvolvedores escrevam aplicativos de implantação personalizados. Os aplicativos podem usar essa API para se comunicar com o servidor WDS para obter informações sobre imagens do sistema disponíveis no servidor. Os aplicativos cliente WDS personalizados devem seguir as diretrizes a seguir.
Instalar a função WDS no servidor
- O WDS (Serviços de Implantação do Windows) é a versão revisada dos RIS (Serviços de Instalação Remota), você precisará da função de servidor WDS no servidor para implementar soluções de cliente WDS personalizadas.
- O WDS substitui o RIS como o componente padrão a partir do Windows Server 2008 e do Windows Server 2003 pelo Service Pack 2 (SP2).
- Você deve atualizar o servidor RIS para o WDS no Windows Server 2003 com Service Pack 1 (SP1). Você pode instalar a função de servidor WDS com o WAIK (Kit de Instalação Automatizada do Windows).
Iniciar o Windows PE 2.0
O Windows PE 2.0 deve ser iniciado, caso ainda não tenha sido iniciado. O cliente WDS e as DLLs de suporte são carregados apenas por setup.exe quando ele está na fase de processamento de instalação do Windows PE 2.0 (Ambiente de Pré-Instalação do Microsoft Windows).
- Quando um novo computador está conectado à rede, a tecnologia interna de PXE (ambiente de execução de pré-inicialização) pode ser usada para baixar o Programa de Inicialização de Rede. Para obter mais informações sobre como inicializar um computador para instalar o Windows, consulte o Guia passo a passo da atualização dos Serviços de Implantação do Windows.
- Uma imagem inicializável do RAMDISK do Windows PE 2.0 pode ser armazenada no . Formato WIM e baixado como parte do processo de inicialização de rede. Em seguida, o Windows PE pode ser carregado e executado diretamente nessa mídia.
Abrir uma sessão com o servidor WDS
O cliente WDS deve abrir uma sessão com um servidor WDS.
- Use a função WdsCliCreateSession para abrir uma sessão com um servidor WDS. Essa função usa o nome ou o endereço IP do servidor e recebe o endereço do identificador para a sessão do cliente WDS.
- Se abrir a sessão com o servidor exigir a autenticação do cliente WDS, o aplicativo deverá fornecer o endereço de uma estrutura WDS_CLI_CRED que contém as credenciais do cliente ao chamar a função WdsCliCreateSession . O aplicativo pode usar a função WdsCliAuthorizeSession para converter uma sessão anônima em uma sessão autenticada.
- Quando a sessão aberta com a função WdsCliCreateSession não é mais necessária, o aplicativo deve usar a função WdsCliClose para fechar o identificador e liberar recursos mantidos pela sessão.
Enumerar imagens do sistema no servidor WDS
O cliente WDS pode usar a API para enumerar as imagens do sistema no servidor WDS.
- Use a função WdsCliFindFirstImage para obter um identificador para a primeira imagem e para inicializar a enumeração de imagens no servidor WDS.
- Use a função WdsCliFindNextImage para incrementar a enumeração iniciada pela função WdsCliFindFirstImage . A função WdsCliFindNextImage obtém o identificador para a próxima imagem.
- Use a função WdsCliGetImageIndex para obter o índice de imagem da imagem atual. Esse valor é válido somente até que as funções WdsCliFindNextImage ou WdsCliClose sejam usadas novamente.
- Use a função WdsCliGetEnumerationFlags para obter sinalizadores informativos sobre a filtragem de imagens.
Obter informações sobre imagens
O cliente WDS pode usar a API para obter informações sobre as imagens em um servidor WDS. As funções a seguir obtêm informações sobre a imagem atual. Como as funções WdsCliFindFirstImage e WdsCliFindNextImage alteram o valor atual do identificador de imagem, o aplicativo deve armazenar todas as informações que obtém e precisará no futuro antes de chamar as funções WdsCliFindFirstImage ou WdsCliFindNextImage novamente.
- Use a função WdsCliGetImageArchitecture para obter a arquitetura do processador da imagem atual.
- Use a função WdsCliGetImagePath para obter o caminho relativo para o arquivo de imagem que contém a imagem atual.
- Use a função WdsCliGetImageSize para obter o tamanho da imagem.
- Use a função WdsCliGetImageVersion para obter a versão da imagem.
- Use a função WdsCliGetImageLanguage para obter o idioma padrão da imagem atual.
- Use a função WdsCliGetImageLanguages para obter uma matriz de idiomas compatíveis com a imagem atual.
- Usar o WdsCliGetImageLastModifiedTime retorna a hora da última modificação para a imagem atual.
- Use a função WdsCliGetImageName para obter o nome da imagem atual.
- Use a função WdsCliGetImageDescription para obter a descrição da imagem atual.
- Use a função WdsCliGetImageGroup para obter o nome do grupo de imagens para a imagem atual.
- Use a função WdsCliGetImageHalName para obter o nome HAL (Camada de Abstração de Hardware) da imagem atual.
Eventos de cliente do WDS de log
A funcionalidade de log da biblioteca de clientes do WDS permite que os eventos de progresso da instalação sejam enviados do cliente para o servidor WDS.
- Use a função WdsCliInitializeLog para inicializar o log para a sessão do cliente WDS.
- Use a função WdsCliLog para gravar mensagens de evento no log do servidor WDS.
- No Windows Server 2008, o servidor WDS grava eventos de cliente em um log de eventos específico do aplicativo que pode ser visualizado por meio de eventvwr.exe, bem como o log de rastreamento de depuração. No Windows Server 2003 com o log de depuração habilitado, o servidor WDS gravará eventos de cliente no arquivo de log localizado em %windir%\tracing\wdsserver.log. O log do cliente WDS deve ser habilitado no servidor para capturar esses eventos.
Tópicos relacionados