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

Статья
08/27/2023

Функция CryptGetDefaultOIDDllList получает список имен DLL-файлов, содержащих зарегистрированные функции идентификатора объекта по умолчанию (OID) для указанного набора функций и типа кодирования.

Синтаксис

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

Параметры

[in] hFuncSet

Дескриптор набора функций, полученный ранее при вызове CryptInitOIDFunctionSet.

[in] dwEncodingType

Указывает тип кодировки для сопоставления. В настоящее время используются только X509_ASN_ENCODING и PKCS_7_ASN_ENCODING; однако в будущем могут быть добавлены дополнительные типы кодирования. Чтобы сопоставить оба текущих типа кодировки, используйте:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Примечание Требуется сертификат или тип кодирования сообщения . X509_ASN_ENCODING используется по умолчанию. Если этот тип указан, он используется; В противном случае, если указан тип PKCS7_ASN_ENCODING, он используется.

[out] pwszDllList

Указатель на буфер для получения списка имен файлов, заканчивающихся null или более. Возвращаемый список завершается завершающим символом NULL . Например, список из двух имен может быть следующим:

L"first.dll\0" L"second.dll\0" L"\0"

Чтобы получить количество расширенных символов, которые должен содержать буфер, этот параметр может иметь значение NULL. Дополнительные сведения см. в разделе Извлечение данных неизвестной длины.

[in, out] pcchDllList

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

Примечание При обработке данных, возвращаемых в буфере, приложения должны использовать фактический размер возвращаемых данных. Фактический размер может быть немного меньше размера буфера, указанного во входных данных. На входных данных размеры буфера обычно указываются достаточно большими, чтобы обеспечить максимально возможное количество выходных данных в буфере. В выходных данных переменная, на которую указывает этот параметр, обновляется с учетом фактического размера данных, скопированных в буфер.

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

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

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

Эта функция имеет следующие коды ошибок.

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

Код возврата

Описание

ERROR_MORE_DATA

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

Требования


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

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

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

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