estructura NETSETUP_PROVISIONING_PARAMS (lmjoin.h)

Artículo
03/14/2023

La estructura NETSETUP_PROVISIONING_PARAMS contiene información que se usa al crear un paquete de aprovisionamiento mediante la función NetCreateProvisionPackage .

Sintaxis

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;

Miembros

dwVersion

Versión de Windows en el paquete de aprovisionamiento. Este parámetro debe usar el siguiente valor definido en el archivo de encabezado Lmjoin.h .

Valor	Significado
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION 0x00000001	La versión de este paquete es Windows Server 2012.

lpDomain

Puntero a una cadena de caracteres terminada en NULL que especifica el nombre del dominio donde se crea la cuenta de equipo.

lpHostName

Puntero a una cadena de caracteres terminada en NULL que especifica el nombre corto de la máquina desde la que se deriva el atributo de cuenta de equipo sAMAccountName anexando "$". Este parámetro debe contener un nombre de equipo DNS o NetBIOS válido.

lpMachineAccountOU

Puntero opcional a una cadena de caracteres terminada en NULL que contiene el nombre de formato RFC 1779 de la unidad organizativa (OU) donde se creará la cuenta de equipo. Si especifica este parámetro, la cadena debe contener una ruta de acceso completa, por ejemplo, OU=testOU,DC=domain,DC=Domain,DC=com. De lo contrario, este parámetro debe ser NULL.

Si este parámetro es NULL, el contenedor de objetos de equipo conocido se usará como publicado en el dominio.

lpDcName

Puntero opcional a una cadena de caracteres terminada en NULL que contiene el nombre del controlador de dominio de destino.

dwProvisionOptions

Conjunto de marcas de bits que definen las opciones de aprovisionamiento. Este parámetro puede ser uno o varios de los siguientes valores definidos en el archivo de encabezado Lmjoin.h .

Valor	Significado
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT 0x00000001	Si el autor de la llamada requiere la creación de cuentas por privilegios, esta opción provocará un reintento en caso de error mediante funciones de creación de cuentas que habilitan la interoperabilidad con controladores de dominio que se ejecutan en versiones anteriores de Windows. El lpMachineAccountOU no se admite al usar la compatibilidad con privilegios de nivel inferior.
NETSETUP_PROVISION_REUSE_ACCOUNT 0x00000002	Si la cuenta con nombre ya existe, se intentará reutilizar la cuenta existente. Esta opción requiere credenciales suficientes para esta operación (administrador de dominio o el propietario del objeto).
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD 0x00000004	Use la contraseña de cuenta de máquina predeterminada, que es el nombre de la máquina en minúsculas. Esto es principalmente para admitir el modelo de combinación no seguro anterior en el que la cuenta creada previamente suele usar esta contraseña predeterminada.
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH 0x00000008	No intente encontrar la cuenta en ningún controlador de dominio del dominio. Esta opción hace que la operación sea más rápida, pero solo se debe usar cuando el autor de la llamada está seguro de que no se ha creado recientemente una cuenta con el mismo nombre. Esta opción solo es válida cuando se especifica el parámetro lpDcName . Cuando se cumplen los requisitos previos, esta opción permite un aprovisionamiento más rápido útil para escenarios como el procesamiento por lotes.
NETSETUP_PROVISION_ROOT_CA_CERTS 0x00000010	Esta opción recupera todos los certificados raíz de la entidad de certificación en el equipo local y los agrega al paquete de aprovisionamiento. Nota Esta marca solo es compatible con la función NetCreateProvisioningPackage en Windows 8, Windows Server 2012 y versiones posteriores.

aCertTemplateNames

Puntero a una matriz de nombres de plantilla de certificado terminadas en NULL.

cCertTemplateNames

Cuando aCertTemplateNames no es NULL, este miembro proporciona un recuento explícito del número de elementos de la matriz.

aMachinePolicyNames

Puntero a una matriz de nombres de directiva de máquina terminadas en NULL.

cMachinePolicyNames

Cuando aMachinePolicyNames no es NULL, este miembro proporciona un recuento explícito del número de elementos de la matriz.

aMachinePolicyPaths

Puntero a una matriz de cadenas de caracteres. Cada elemento de matriz es una cadena de caracteres terminada en NULL que especifica la ruta de acceso completa o parcial a un archivo en el formato de archivo de directiva del Registro. Para obtener más información sobre el formato de archivo de directiva del Registro, vea Formato de archivo de directiva del Registro.

Esta ruta de acceso podría ser una ruta unc en un servidor remoto.

cMachinePolicyPaths

Cuando aMachinePolicyPaths no es NULL, este miembro proporciona un recuento explícito del número de elementos de la matriz.

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

Comentarios

La estructura de NETSETUP_PROVISIONING_PARAMS proporciona marcas para la función NetCreateProvisioningPackage que se admite en Windows 8 y Windows Server 2012 para las operaciones de combinación sin conexión.

Además de las combinaciones de dominio, el paquete de aprovisionamiento puede proporcionar certificados y directivas a la máquina. El paquete de aprovisionamiento se puede usar de cuatro maneras:

Unión a un dominio
Unión a un dominio e instalación de certificados
Unión a un dominio e instalación de directivas
Unión a un dominio e instalación de certificados y directivas

Cuando es necesario agregar certificados al paquete, esta estructura proporciona el miembro aCertTemplateNames como una matriz de nombres de plantilla de certificado terminadas en NULL. El miembro aCertTemplateNames requiere que el miembro cCertTemplateNames proporcione un recuento explícito del número de elementos de la matriz.

Hay dos maneras diferentes de agregar directivas. Puede usar uno o ambos métodos:

Nombre de directiva: se proporciona una matriz de nombres de directiva terminadas en NULL en el miembro aMachinePolicyNames . Durante el tiempo de ejecución, el nombre de la directiva se asigna al nombre de la directiva en AD y se recupera el GUID que representa la directiva en el espacio empresarial. El miembro aMachinePolicyNames requiere que el miembro cMachinePolicyNames proporcione un recuento explícito del número de elementos de la matriz.
Ruta de acceso de directiva: puntero a una matriz de cadenas de caracteres terminadas en NULL proporcionadas en el miembro aMachinePolicyPaths que especifica la ruta de acceso a un archivo en el formato de archivo de directiva del Registro. Para obtener más información sobre el formato de archivo de directiva del Registro, vea Formato de archivo de directiva del Registro. La ruta de acceso de la directiva es una ruta de acceso completa o relativa al archivo de directiva.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	lmjoin.h (include Lm.h)