структура NETSETUP_PROVISIONING_PARAMS (lmjoin.h)

Статья
03/05/2024

Структура NETSETUP_PROVISIONING_PARAMS содержит сведения, используемые при создании пакета подготовки с помощью функции NetCreateProvisionPackage .

Синтаксис

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;

Члены

dwVersion

Версия Windows в пакете подготовки. Этот параметр должен использовать следующее значение, определенное в файле заголовка Lmjoin.h .

Значение	Значение
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION 0x00000001	Версия этого пакета — Windows Server 2012.

lpDomain

Указатель на символьную строку, завершающуюся значением NULL, которая указывает имя домена, в котором создается учетная запись компьютера.

lpHostName

Указатель на символьную строку, завершающуюся значением NULL, которая указывает короткое имя компьютера, из которого извлекается атрибут учетной записи компьютера sAMAccountName путем добавления символа "$". Этот параметр должен содержать допустимое имя компьютера DNS или NetBIOS.

lpMachineAccountOU

Необязательный указатель на символьную строку, завершающуюся значением NULL, которая содержит имя в формате RFC 1779 подразделения, в котором будет создана учетная запись компьютера. Если указать этот параметр, строка должна содержать полный путь, например OU=testOU,DC=domain,DC=Domain,DC=com. В противном случае этот параметр должен иметь значение NULL.

Если этот параметр имеет значение NULL, хорошо известный контейнер объектов-компьютеров будет использоваться как опубликованный в домене.

lpDcName

Необязательный указатель на строку символов, завершающуюся null, которая содержит имя целевого контроллера домена.

dwProvisionOptions

Набор битовых флагов, определяющих параметры подготовки. Этот параметр может быть одним или несколькими из следующих значений, определенных в файле заголовка Lmjoin.h .

Значение	Значение
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT 0x00000001	Если вызывающей стороне требуется создать учетную запись с помощью привилегий, этот параметр приведет к повторной попытке при сбое с помощью функций создания учетной записи, позволяющих взаимодействовать с контроллерами домена, работающими в более ранних версиях Windows. LpMachineAccountOU не поддерживается при использовании поддержки привилегий нижнего уровня.
NETSETUP_PROVISION_REUSE_ACCOUNT 0x00000002	Если именованной учетной записи уже существует, будет предпринята попытка повторного использования существующей учетной записи. Для этого параметра требуются достаточные учетные данные для этой операции (администратор домена или владелец объекта).
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD 0x00000004	Используйте пароль учетной записи компьютера по умолчанию, который является именем компьютера в нижнем регистре. Это в основном для поддержки более старой небезопасной модели присоединения, где предварительно созданная учетная запись обычно использует этот пароль по умолчанию.
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH 0x00000008	Не пытайтесь найти учетную запись на контроллере домена в домене. Этот параметр ускоряет операцию, но его следует использовать только в том случае, если вызывающий объект уверен, что учетная запись с таким же именем не была создана недавно. Этот параметр действителен, только если указан параметр lpDcName . При выполнении предварительных требований этот параметр позволяет ускорить подготовку , полезную для таких сценариев, как пакетная обработка.
NETSETUP_PROVISION_ROOT_CA_CERTS 0x00000010	Этот параметр извлекает все корневые сертификаты центра сертификации на локальном компьютере и добавляет их в пакет подготовки. Примечание Этот флаг поддерживается функцией NetCreateProvisioningPackage только в Windows 8, Windows Server 2012 и более поздних версиях.

aCertTemplateNames

Указатель на массив имен шаблонов сертификатов, завершаемых значением NULL.

cCertTemplateNames

Если aCertTemplateNames не равно NULL, этот элемент предоставляет явное количество элементов в массиве.

aMachinePolicyNames

Указатель на массив имен политик компьютеров, завершаемых значением NULL.

cMachinePolicyNames

Если значениеMachinePolicyNames не равно NULL, этот элемент предоставляет явное количество элементов в массиве.

aMachinePolicyPaths

Указатель на массив символьных строк. Каждый элемент массива представляет собой символьную строку, завершающуюся значением NULL, которая указывает полный или частичный путь к файлу в формате файла политики реестра. Дополнительные сведения о формате файла политики реестра см. в разделе Формат файла политики реестра.

Этот путь может быть UNC-путем на удаленном сервере.

cMachinePolicyPaths

Если значениеMachinePolicyPaths не равно NULL, этот элемент предоставляет явное количество элементов в массиве.

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

Помимо присоединения к домену пакет подготовки может предоставлять сертификаты и политики для компьютера. Пакет подготовки можно использовать четырьмя способами:

Присоединение к домену
Присоединение к домену и установка сертификатов
Присоединение к домену и установка политик
Присоединение к домену и установка сертификатов и политик

Если сертификаты необходимо добавить в пакет, эта структура предоставляет элементCertTemplateNames в виде массива имен шаблонов сертификатов, завершаемых значением NULL. Член aCertTemplateNames требует, чтобы элемент cCertTemplateNames предоставлял явное количество элементов в массиве.

Существует два разных способа добавления политик. Можно использовать один или оба метода:

Имя политики — массив имен политик, завершаемых значением NULL, предоставляется в элементеMachinePolicyNames . Во время выполнения имя политики сопоставляется с именем политики в AD и извлекается GUID, представляющий политику в корпоративном пространстве. Член aMachinePolicyNames требует, чтобы элемент cMachinePolicyNames предоставлял явное количество элементов в массиве.
Путь политики — указатель на массив символьных строк, заканчивающихся значением NULL, указанных в элементеMachinePolicyPaths , который задает путь к файлу в формате файла политики реестра. Дополнительные сведения о формате файла политики реестра см. в разделе Формат файла политики реестра. Путь политики — это полный или относительный путь к файлу политики.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Верхняя часть	lmjoin.h (включая Lm.h)