Поделиться через

Метод ICertAdmin2::SetConfigEntry (certadm.h)

  • Статья

Метод SetConfigEntry задает сведения о конфигурации для центра сертификации (ЦС).

Синтаксис

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

Параметры

[in] strConfig

Строковое значение, представляющее допустимую строку конфигурации для ЦС в формате COMPUTERNAME\CANAME, где COMPUTERNAME — сетевое имя сервера служб сертификации, а CANAME — общее имя ЦС, указанное при настройке служб сертификации. Дополнительные сведения об имени строки конфигурации см. в разделе ICertConfig. Этот параметр может быть пустой строкой. В этом случае функция задает сведения о конфигурации, не относящиеся к ЦС. Этот параметр не может иметь значение NULL.

Важно!SetConfigEntry не очищает внутренний кэш при изменении строки конфигурации. При изменении строки конфигурации для ЦС необходимо создать экземпляр нового объекта ICertAdmin и снова вызвать этот метод с новой строкой конфигурации.
 

[in] strNodePath

Строковое значение, представляющее путь к узлу для сведений о конфигурации. Этот параметр может быть пустой строкой. В этом случае функция получает сведения о конфигурации из пути, определенного strConfig. Этот параметр не может иметь значение NULL.

[in] strEntryName

Строковое значение, представляющее имя записи, сведения которой задаются. Это значение может быть пустой строкой, в этом случае записью по умолчанию является задается запись. Этот параметр не может иметь значение NULL.

[in] pvarEntry

C++ Указатель на VARIANT , указывающий устанавливаемые сведения. Если это значение пустое, указанный ключ будет удален.
VB Variant , указывающий устанавливаемые сведения. Если это значение пустое, указанный ключ будет удален.

Возвращаемое значение

VB

Если функция выполнена успешно, возвращаемое значение будет S_OK.

Если функция завершается сбоем, возвращаемым значением является HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Комментарии

Сведения о конфигурации хранятся в реестре по следующему пути.

HKEY_LOCAL_MACHINE\СИСТЕМЫ\CurrentControlSet\Услуги\CertSvc\Конфигурации\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Где CASANITIZEDNAME — это дезинфицированное имя ЦС. Дополнительные сведения о дезинфицированных именах см. в разделе ICertConfig2::GetConfig.

Требования

   
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header certadm.h (включая Certsrv.h)
Библиотека Certidl.lib
DLL Certadm.dll

См. также раздел

ICertAdmin2