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

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

  • Статья

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

Синтаксис

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

Параметры

[in] strConfig

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

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

[in] strNodePath

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

[in] strEntryName

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

[out] pvarEntry

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

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

C++

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

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

VB

Возвращаемым значением является Значение Variant , представляющее полученные сведения о конфигурации.

Комментарии

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

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