Compartir a través de


estructura NETSETUP_PROVISIONING_PARAMS (lmjoin.h)

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)

Consulte también

NetCreateProvisionPackage

NetJoinDomain

NetProvisionComputerAccount

NetRenameMachineInDomain

NetRequestOfflineDomainJoin

NetRequestProvisioningPackageInstall

NetUnjoinDomain

Funciones de administración de red

Introducción a la administración de redes