Função CryptGetDefaultOIDDllList (wincrypt.h)

Artigo
08/27/2023

A função CryptGetDefaultOIDDllList adquire a lista dos nomes de arquivos DLL que contêm funções OID ( identificador de objeto padrão) registradas para um conjunto de funções e um tipo de codificação especificados.

Sintaxe

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

Parâmetros

[in] hFuncSet

Identificador do conjunto de funções obtido anteriormente por uma chamada para CryptInitOIDFunctionSet.

[in] dwEncodingType

Especifica o tipo de codificação a ser correspondido. Atualmente, apenas X509_ASN_ENCODING e PKCS_7_ASN_ENCODING estão sendo usados; no entanto, tipos de codificação adicionais podem ser adicionados no futuro. Para corresponder aos dois tipos de codificação atuais, use:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Nota Um tipo de codificação de certificado ou mensagem é necessário. X509_ASN_ENCODING é o padrão. Se esse tipo for indicado, ele será usado; caso contrário, se o tipo PKCS7_ASN_ENCODING for indicado, ele será usado.

[out] pwszDllList

Um ponteiro para um buffer para receber a lista de zero ou mais nomes de arquivo encerrados em nulo. A lista retornada é encerrada com um caractere NULL de terminação. Por exemplo, uma lista de dois nomes pode ser:

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

Para recuperar o número de caracteres largos que o buffer deve conter, esse parâmetro pode ser NULL. Para obter mais informações, consulte Recuperando dados de comprimento desconhecido.

[in, out] pcchDllList

Um ponteiro para um DWORD que especifica o tamanho, em caracteres largos, da lista retornada apontada pelo parâmetro pwszDllList . Quando a função retorna, a variável apontada pelo parâmetro pcchDllList contém o número de caracteres largos armazenados no buffer.

Nota Ao processar os dados retornados no buffer, os aplicativos precisam usar o tamanho real dos dados retornados. O tamanho real pode ser um pouco menor do que o tamanho do buffer especificado na entrada. Na entrada, os tamanhos de buffer geralmente são especificados grandes o suficiente para garantir que os maiores dados de saída possíveis se encaixem no buffer. Na saída, a variável apontada por esse parâmetro é atualizada para refletir o tamanho real dos dados copiados para o buffer.

Valor retornado

Se a função for bem-sucedida, a função retornará diferente de zero (TRUE).

Se a função falhar, ela retornará zero (FALSE). Para obter informações de erro estendidas, chame GetLastError.

Essa função tem os seguintes códigos de erro.

Código de retorno	Descrição
ERROR_MORE_DATA	Se o buffer especificado pelo parâmetro pwszDllList não for grande o suficiente para manter os dados retornados, a função definirá o código ERROR_MORE_DATA e armazenará o tamanho do buffer necessário, em caracteres largos, na variável apontada por pcchDllList.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll

Confira também

Funções de suporte do OID

Compartilhar via