Função NetRequestOfflineDomainJoin (lmjoin.h)
A função NetRequestOfflineDomainJoin é executada localmente em um computador para modificar uma imagem do sistema operacional Windows montada em um volume. O registro é carregado da imagem e os dados de blob de provisionamento são gravados onde podem ser recuperados durante a fase de conclusão de uma operação de junção de domínio offline.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetRequestOfflineDomainJoin(
[in] BYTE *pProvisionBinData,
[in] DWORD cbProvisionBinDataSize,
[in] DWORD dwOptions,
[in] LPCWSTR lpWindowsPath
);
Parâmetros
[in] pProvisionBinData
Um ponteiro para um buffer necessário para inicializar o registro de uma imagem do sistema operacional Windows para processar a alteração de estado local final durante a fase de conclusão da operação de ingresso no domínio offline.
O blob binário opaco de metadados serializados passados no parâmetro pProvisionBinData é retornado pela função NetProvisionComputerAccount .
[in] cbProvisionBinDataSize
O tamanho, em bytes, do buffer apontado pelo parâmetro pProvisionBinData .
Esse parâmetro não deve ser NULL.
[in] dwOptions
Um conjunto de sinalizadores de bits que definem opções para essa função. Esse parâmetro pode ser um ou mais dos valores a seguir definidos no arquivo de cabeçalho Lmjoin.h .
[in] lpWindowsPath
Um ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o caminho para uma imagem do sistema operacional Windows na qual os hives do Registro estão localizados. Essa imagem deve estar offline e não ser inicializada no momento, a menos que o parâmetro dwOptions contenha NETSETUP_PROVISION_ONLINE_CALLER nesse caso, o diretório do sistema operacional em execução localmente é permitido.
Esse caminho pode ser um caminho UNC em um servidor remoto.
Valor retornado
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir ou um dos códigos de erro do sistema.
| Código de retorno | Descrição |
|---|---|
|
O acesso foi negado. Esse erro será retornado se o chamador não tiver privilégios suficientes para concluir a operação. |
|
A operação solicitada requer elevação. |
|
Um parâmetro está incorreto. Esse erro será retornado se os parâmetros pProvisionBinData, cbProvisionBinDataSize ou lpWindowsPath forem NULL. Esse erro também será retornado se o buffer apontado pelo parâmetro pProvisionBinData não contiver dados válidos no blob para o domínio, o nome da conta do computador ou a senha da conta do computador. Esse erro também será retornado se a cadeia de caracteres apontada para o parâmetro lpWindowsPath não especificar o caminho para uma imagem do sistema operacional Windows. |
|
A solicitação não terá suporte. Esse erro será retornado se o servidor especificado não der suporte a essa operação. Por exemplo, se o parâmetro lpWindowsPath referenciar uma instalação do Windows configurada como um controlador de domínio. |
|
O serviço estação de trabalho não foi iniciado. |
Comentários
A função NetRequestOfflineDomainJoin tem suporte no Windows 7 para operações de ingresso no domínio offline.
A função NetRequestOfflineDomainJoin é usada localmente em um computador para modificar uma imagem do sistema operacional Windows montada em um volume. O registro é carregado para a imagem e os dados de blob de provisionamento são gravados onde podem ser recuperados durante a fase de conclusão de uma operação de junção de domínio offline. O cenário de ingresso no domínio offline usa essas funções da seguinte maneira:
- NetProvisionComputerAccount é uma função de provisionamento que é chamada primeiro para executar as operações de rede necessárias para criar e configurar o objeto de computador no Active Directory. A saída do NetProvisionComputerAccount é um blob binário opaco de metadados serializados usado para a próxima etapa.
- NetRequestOfflineDomainJoin , uma função de inicialização de imagem, é então chamada para injetar a saída da função de provisionamento NetProvisionComputerAccount em uma imagem do sistema operacional Windows a ser usada durante a instalação. As alterações no código de inicialização do Windows detectarão esse estado salvo e afetarão a única parte local da junção de domínio.
A função NetProvisionComputerAccount criará ou reutilizará a conta do computador no domínio, coletará todos os metadados necessários e a retornará em um blob binário com controle de versão opaco ou como texto para inserção em um arquivo de resposta de instalação autônoma. O blob binário opaco pode ser consumido pela operação de solicitação de ingresso no domínio offline que fornece toda a entrada necessária para concluir a junção de domínio durante a primeira inicialização sem nenhuma operação de rede (somente atualizações de estado local). Observe que o blob contém o material de senha da conta do computador essencialmente na limpeza. O design não faz nenhuma provisão para proteger esses dados. Esse problema existe hoje com arquivos de resposta de instalação autônoma que podem conter vários segredos, incluindo senhas de usuário de domínio. O chamador deve proteger o blob e os arquivos de instalação autônoma. As soluções para esse problema são variadas. Por exemplo, uma chave pré-trocada pode ser usada para criptografar uma sessão entre o consumidor e a entidade de provisionamento, permitindo uma transferência segura do blob opaco.
O blob opaco retornado no parâmetro pProvisionBinData pela função NetProvisionComputerAccount tem controle de versão para permitir cenários de interoperabilidade e de serviço entre diferentes versões do Windows (cliente de junção, computador de provisionamento e controlador de domínio). O cenário de junção offline atualmente não limita o tempo de vida do blob retornado pela função NetProvisionComputerAccount .
Para obter mais informações sobre operações de ingresso no domínio offline, consulte o Guia passo a passo de ingresso no domínio offline.
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | lmjoin.h (inclua Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |
Confira também
NetRequestProvisioningPackageInstall
Funções de gerenciamento de rede