estrutura NETSETUP_PROVISIONING_PARAMS (lmjoin.h)
A estrutura NETSETUP_PROVISIONING_PARAMS contém informações usadas ao criar um pacote de provisionamento usando a função NetCreateProvisionPackage .
Sintaxe
typedef struct _NETSETUP_PROVISIONING_PARAMS {
DWORD dwVersion;
LPCWSTR lpDomain;
LPCWSTR lpHostName;
LPCWSTR lpMachineAccountOU;
LPCWSTR lpDcName;
DWORD dwProvisionOptions;
LPCWSTR *aCertTemplateNames;
DWORD cCertTemplateNames;
LPCWSTR *aMachinePolicyNames;
DWORD cMachinePolicyNames;
LPCWSTR *aMachinePolicyPaths;
DWORD cMachinePolicyPaths;
LPWSTR lpNetbiosName;
LPWSTR lpSiteName;
LPWSTR lpPrimaryDNSDomain;
} NETSETUP_PROVISIONING_PARAMS, *PNETSETUP_PROVISIONING_PARAMS;
Membros
dwVersion
A versão do Windows no pacote de provisionamento. Esse parâmetro deve usar o valor a seguir definido no arquivo de cabeçalho Lmjoin.h .
| Valor | Significado |
|---|---|
|
A versão desse pacote é Windows Server 2012. |
lpDomain
Um ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome do domínio em que a conta de computador é criada.
lpHostName
Um ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome curto do computador do qual o atributo de conta de computador sAMAccountName é derivado acrescentando um '$'. Esse parâmetro deve conter um nome de computador DNS ou NetBIOS válido.
lpMachineAccountOU
Um ponteiro opcional para uma cadeia de caracteres terminada em NULL que contém o nome do formato RFC 1779 da UO (unidade organizacional) em que a conta do computador será criada. Se você especificar esse parâmetro, a cadeia de caracteres deverá conter um caminho completo, por exemplo, OU=testOU,DC=domain,DC=Domain,DC=com. Caso contrário, esse parâmetro deve ser NULL.
Se esse parâmetro for NULL, o contêiner de objeto de computador conhecido será usado como publicado no domínio.
lpDcName
Um ponteiro opcional para uma cadeia de caracteres terminada em NULL que contém o nome do controlador de domínio a ser direcionado.
dwProvisionOptions
Um conjunto de sinalizadores de bits que definem opções de provisionamento. Esse parâmetro pode ser um ou mais dos valores a seguir definidos no arquivo de cabeçalho Lmjoin.h .
| Valor | Significado |
|---|---|
|
Se o chamador exigir a criação da conta por privilégio, essa opção causará uma nova tentativa de falha usando funções de criação de conta, permitindo a interoperabilidade com controladores de domínio em execução em versões anteriores do Windows.
Não há suporte para lpMachineAccountOU ao usar o suporte a privilégios de nível inferior. |
|
Se a conta nomeada já existir, será feita uma tentativa de reutilizar a conta existente.
Essa opção requer credenciais suficientes para essa operação (Administrador de Domínio ou o proprietário do objeto). |
|
Use a senha da conta de computador padrão, que é o nome do computador em letras minúsculas. Isso é em grande parte para dar suporte ao modelo de junção não seguro mais antigo em que a conta pré-criada normalmente usava essa senha padrão. |
|
Não tente localizar a conta em nenhum controlador de domínio no domínio. Essa opção torna a operação mais rápida, mas só deve ser usada quando o chamador tiver certeza de que uma conta com o mesmo nome não foi criada recentemente.
Essa opção só é válida quando o parâmetro lpDcName é especificado. Quando os pré-requisitos são atendidos, essa opção permite provisionamento mais rápido útil para cenários como processamento em lotes. |
|
Essa opção recupera todos os certificados raiz da Autoridade de Certificação no computador local e os adiciona ao pacote de provisionamento.
Nota Esse sinalizador só tem suporte da função NetCreateProvisioningPackage em Windows 8, Windows Server 2012 e posterior.
|
aCertTemplateNames
Um ponteiro para uma matriz de nomes de modelo de certificado terminados em NULL.
cCertTemplateNames
Quando aCertTemplateNames não é NULL, esse membro fornece uma contagem explícita do número de itens na matriz.
aMachinePolicyNames
Um ponteiro para uma matriz de nomes de política de computador terminados em NULL.
cMachinePolicyNames
Quando aMachinePolicyNames não é NULL, esse membro fornece uma contagem explícita do número de itens na matriz.
aMachinePolicyPaths
Um ponteiro para uma matriz de cadeias de caracteres. Cada elemento de matriz é uma cadeia de caracteres terminada em NULL que especifica o caminho completo ou parcial para um arquivo no formato Arquivo de Política do Registro. Para obter mais informações sobre o formato de arquivo de política do Registro , consulte Formato de arquivo de política do registro
Esse caminho pode ser um caminho UNC em um servidor remoto.
cMachinePolicyPaths
Quando aMachinePolicyPaths não é NULL, esse membro fornece uma contagem explícita do número de itens na matriz.
lpNetbiosName
TBD
lpSiteName
TBD
lpPrimaryDNSDomain
TBD
Comentários
A estrutura NETSETUP_PROVISIONING_PARAMS fornece sinalizadores para a função NetCreateProvisioningPackage que tem suporte em Windows 8 e Windows Server 2012 para operações de junção offline.
Além das junções de domínio, o pacote de provisionamento pode fornecer certificados e políticas para o computador. O pacote de provisionamento pode ser usado de quatro maneiras:
- Ingresso no domínio
- Ingresso no domínio e instalação de certificados
- Ingresso no domínio e instalação de políticas
- Ingresso no domínio e instalação de certificados e políticas
Quando os certificados precisam ser adicionados ao pacote, essa estrutura fornece o membro aCertTemplateNames como uma matriz de nomes de modelo de certificado terminados em NULL. O membro aCertTemplateNames requer que o membro cCertTemplateNames forneça uma contagem explícita do número de itens na matriz.
Há duas maneiras diferentes de adicionar políticas. Você pode usar um ou ambos os métodos:
- Nome da política — uma matriz de nomes de política terminadas em NULL é fornecida no membro aMachinePolicyNames . Durante o runtime, o nome da política é mapeado para o nome da política no AD e o GUID que representa a política no espaço empresarial é recuperado. O membro aMachinePolicyNames requer que o membro cMachinePolicyNames forneça uma contagem explícita do número de itens na matriz.
- Caminho da política — um ponteiro para uma matriz de cadeias de caracteres terminadas em NULL fornecidas no membro aMachinePolicyPaths que especificam o caminho para um arquivo no formato Arquivo de Política do Registro. Para obter mais informações sobre o Formato de Arquivo de Política do Registro, consulte Formato de arquivo de política do registro. O caminho da política é um caminho completo ou relativo para o arquivo de política.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Cabeçalho | lmjoin.h (inclua Lm.h) |
Confira também
NetRequestProvisioningPackageInstall