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

  • Статья

Функция CryptEnumOIDFunction перечисляет зарегистрированные функции идентификатора объекта (OID). Перечислимые функции OID можно просмотреть, чтобы включить те, которые идентифицируются по типу кодирования, имени функции, OID или любому сочетанию типа кодирования, имени функции и OID. Для каждой функции OID, которая соответствует критериям выбора, вызывается функция обратного вызова, предоставляемая приложением, pfnEnumOIDFunc.

Синтаксис

BOOL CryptEnumOIDFunction(
  [in] DWORD                   dwEncodingType,
  [in] LPCSTR                  pszFuncName,
  [in] LPCSTR                  pszOID,
  [in] DWORD                   dwFlags,
  [in] void                    *pvArg,
  [in] PFN_CRYPT_ENUM_OID_FUNC pfnEnumOIDFunc
);

Параметры

[in] dwEncodingType

Указывает тип кодировки для сопоставления. Установка для этого параметра значения CRYPT_MATCH_ANY_ENCODING_TYPE соответствует любому типу кодирования. Обратите внимание, что если CRYPT_MATCH_ANY_ENCODING_TYPE не указан, требуется сертификат или тип кодирования сообщения . Если низкоупорядоченное слово, содержащее тип кодирования сертификата, не равно нулю, оно используется; в противном случае используется слово высокого порядка, содержащее тип кодирования сообщения. Если указаны оба параметра, используется тип кодирования сертификата в слове нижнего порядка.

В настоящее время определены следующие типы кодирования:

  • CRYPT_ASN_ENCODING
  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING
  • CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

Имя функции, для которой выполняется поиск совпадений без учета регистра. Установка значения NULL для этого параметра приводит к обнаружению совпадения для любого имени функции.

[in] pszOID

Если слово высокого порядка pszOID не равно нулю, pszOID указывает идентификатор объекта, для которого выполняется поиск совпадений без учета регистра. Если слово высокого порядка pszOID равно нулю, pszOID используется для сопоставления идентификатора числового объекта. Установка значения NULL для этого параметра соответствует любому идентификатору объекта. Если задать для этого параметра значение CRYPT_DEFAULT_OID, перечисление ограничивается только функциями по умолчанию.

[in] dwFlags

Зарезервировано для использования в будущем и должно быть равно нулю.

[in] pvArg

Указатель на аргументы, передаваемые в функцию обратного вызова CRYPT_ENUM_OID_FUNCTION .

[in] pfnEnumOIDFunc

Указатель на функцию обратного вызова, которая выполняется для каждой функции OID, которая соответствует входным параметрам. Дополнительные сведения см. в разделе CRYPT_ENUM_OID_FUNCTION.

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

Если функция выполняется успешно, функция возвращает ненулевое значение (TRUE).

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

Требования

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

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

Функции поддержки OID