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 |
|---|---|
|
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 |
|---|---|
|
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. |
|
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). |
|
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. |
|
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. |
|
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
NetRequestProvisioningPackageInstall
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de