NETSETUP_PROVISIONING_PARAMS-Struktur (lmjoin.h)

Artikel
08/24/2023

Die NETSETUP_PROVISIONING_PARAMS-Struktur enthält Informationen, die beim Erstellen eines Bereitstellungspakets mithilfe der NetCreateProvisionPackage-Funktion verwendet werden.

Syntax

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;

Member

dwVersion

Die Version von Windows im Bereitstellungspaket. Dieser Parameter sollte den folgenden Wert verwenden, der in der Lmjoin.h-Headerdatei definiert ist.

Wert	Bedeutung
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION 0x00000001	Die Version für dieses Paket ist Windows Server 2012.

lpDomain

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der Domäne angibt, in der das Computerkonto erstellt wird.

lpHostName

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Kurznamen des Computers angibt, von dem das Computerkonto-Attribut sAMAccountName durch Anfügen eines "$" abgeleitet wird. Dieser Parameter muss einen gültigen DNS- oder NetBIOS-Computernamen enthalten.

lpMachineAccountOU

Ein optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den RFC 1779-Formatnamen der Organisationseinheit (OU) enthält, in der das Computerkonto erstellt wird. Wenn Sie diesen Parameter angeben, muss die Zeichenfolge einen vollständigen Pfad enthalten, z. B. OU=testOU,DC=domain,DC=Domain,DC=com. Andernfalls muss dieser Parameter NULL sein.

Wenn dieser Parameter NULL ist, wird der bekannte Computerobjektcontainer wie in der Domäne veröffentlicht verwendet.

lpDcName

Ein optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Domänencontrollers für das Ziel enthält.

dwProvisionOptions

Eine Reihe von Bitflags, die Bereitstellungsoptionen definieren. Bei diesem Parameter kann es sich um einen oder mehrere der folgenden Werte handeln, die in der Lmjoin.h-Headerdatei definiert sind.

Wert	Bedeutung
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT 0x00000001	Wenn der Aufrufer die Kontoerstellung nach Berechtigungen erfordert, führt diese Option zu einem Wiederholungsfehler mithilfe von Kontoerstellungsfunktionen, die die Interoperabilität mit Domänencontrollern ermöglichen, die unter früheren Versionen von Windows ausgeführt werden. Die lpMachineAccountOU wird nicht unterstützt, wenn Unterstützung für Downlevel-Berechtigungen verwendet wird.
NETSETUP_PROVISION_REUSE_ACCOUNT 0x00000002	Wenn das benannte Konto bereits vorhanden ist, wird versucht, das vorhandene Konto wiederzuverwenden. Diese Option erfordert ausreichende Anmeldeinformationen für diesen Vorgang (Domänenadministrator oder Objektbesitzer).
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD 0x00000004	Verwenden Sie das Standardkennwort für das Computerkonto, bei dem es sich um den Computernamen in Kleinbuchstaben handelt. Dies dient größtenteils der Unterstützung des älteren unsicheren Joinmodells, bei dem das vorab erstellte Konto in der Regel dieses Standardkennwort verwendet.
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH 0x00000008	Versuchen Sie nicht, das Konto auf einem Domänencontroller in der Domäne zu finden. Diese Option beschleunigt den Vorgang, sollte aber nur verwendet werden, wenn der Aufrufer sicher ist, dass vor kurzem kein Konto mit demselben Namen erstellt wurde. Diese Option ist nur gültig, wenn der lpDcName-Parameter angegeben ist. Wenn die Voraussetzungen erfüllt sind, ermöglicht diese Option eine schnellere Bereitstellung, die für Szenarien wie die Batchverarbeitung nützlich ist.
NETSETUP_PROVISION_ROOT_CA_CERTS 0x00000010	Mit dieser Option werden alle Stammzertifikate der Zertifizierungsstelle auf dem lokalen Computer abgerufen und dem Bereitstellungspaket hinzugefügt. Hinweis Dieses Flag wird nur von der NetCreateProvisioningPackage-Funktion auf Windows 8, Windows Server 2012 und höher unterstützt.

aCertTemplateNames

Ein Zeiger auf ein Array von Zertifikatvorlagennamen mit NULL-Beendigung.

cCertTemplateNames

Wenn aCertTemplateNames nicht NULL ist, stellt dieses Element eine explizite Anzahl der Elemente im Array bereit.

aMachinePolicyNames

Ein Zeiger auf ein Array von MIT NULL beendeten Computerrichtliniennamen.

cMachinePolicyNames

Wenn aMachinePolicyNames nicht NULL ist, stellt dieser Member eine explizite Anzahl der Elemente im Array bereit.

aMachinePolicyPaths

Ein Zeiger auf ein Array von Zeichenfolgen. Jedes Arrayelement ist eine NULL-endende Zeichenfolge, die den vollständigen oder teilweisen Pfad zu einer Datei im Format Registrierungsrichtliniendatei angibt. Weitere Informationen zum Dateiformat der Registrierungsrichtlinie finden Sie unter Registrierungsrichtliniendateiformat.

Dieser Pfad kann ein UNC-Pfad auf einem Remoteserver sein.

cMachinePolicyPaths

Wenn aMachinePolicyPaths nicht NULL ist, stellt dieser Member eine explizite Anzahl der Elemente im Array bereit.

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

Hinweise

Die NETSETUP_PROVISIONING_PARAMS-Struktur stellt Flags für die NetCreateProvisioningPackage-Funktion bereit, die auf Windows 8 und Windows Server 2012 für Offlinebeitrittsvorgänge unterstützt wird.

Zusätzlich zu Domänenbeitritten kann das Bereitstellungspaket Zertifikate und Richtlinien für den Computer bereitstellen. Das Bereitstellungspaket kann auf vier Arten verwendet werden:

Domänenbeitritt
Domänenbeitritt und Installation von Zertifikaten
Domänenbeitritt und Installation von Richtlinien
Domänenbeitritt und Installation von Zertifikaten und Richtlinien

Wenn dem Paket Zertifikate hinzugefügt werden müssen, stellt diese Struktur das Element aCertTemplateNames als Array von Zertifikatvorlagennamen mit NULL-Beendigung bereit. Das aCertTemplateNames-Element erfordert, dass das cCertTemplateNames-Element eine explizite Anzahl der Elemente im Array bereitstellt.

Es gibt zwei verschiedene Möglichkeiten, Richtlinien hinzuzufügen. Sie können eine oder beide Methoden verwenden:

Richtlinienname: Im Member aMachinePolicyNames wird ein Array mit NULL-beendeten Richtliniennamen bereitgestellt. Während der Laufzeit wird der Richtlinienname dem Richtliniennamen in AD zugeordnet, und die GUID, die die Richtlinie im Unternehmensbereich darstellt, wird abgerufen. Das Element aMachinePolicyNames erfordert, dass der cMachinePolicyNames-Member eine explizite Anzahl der Elemente im Array bereitstellt.
Richtlinienpfad: Ein Zeiger auf ein Array von NULL-beendeten Zeichenfolgen, die im Member aMachinePolicyPaths bereitgestellt werden und den Pfad zu einer Datei im Format Registrierungsrichtliniendatei angeben. Weitere Informationen zum Registrierungsrichtliniendateiformat finden Sie unter Registrierungsrichtliniendateiformat. Der Richtlinienpfad ist ein vollständiger oder relativer Pfad zur Richtliniendatei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	lmjoin.h (lm.h einschließen)