Функция CertGetValidUsages (wincrypt.h)

  • Статья

Функция CertGetValidUsages возвращает массив использования, состоящий из пересечения допустимых вариантов использования для всех сертификатов в массиве сертификатов.

Синтаксис

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

Параметры

[in] cCerts

Количество сертификатов в массиве для проверки.

[in] rghCerts

Массив сертификатов, которые необходимо проверить на допустимость использования.

[out] cNumOIDs

Число допустимых использования, обнаруженных как пересечение допустимых вариантов использования всех сертификатов в массиве. Если все сертификаты действительны для всех видов использования, для cNumOIDs устанавливается отрицательное значение (–1).

[out] rghOIDs

Массив идентификаторов объектов (OID) допустимых значений использования, которые совместно используются всеми сертификатами в массиве rghCerts . Этот параметр может иметь значение NULL , чтобы задать размер этой структуры в целях выделения памяти. Дополнительные сведения см. в разделе Извлечение данных неизвестной длины.

[in, out] pcbOIDs

Указатель на значение DWORD , указывающее размер (в байтах) массива rghOIDs и строк, на которые указывает. При возврате функции значение DWORD содержит количество байтов, необходимое для массива.

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

Если функция выполняется успешно, возвращается ненулевое значение. Если функция выполняется неудачно, возвращается нулевое значение. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Требования

   
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincrypt.h
Библиотека Crypt32.lib
DLL Crypt32.dll