Функция 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.

Требования