Função CryptEnumOIDFunction (wincrypt.h)

Artigo
03/03/2024

A função CryptEnumOIDFunction enumera as funções OID ( identificador de objeto registrado). As funções OID que são enumeradas podem ser exibidas para incluir aquelas identificadas por seu tipo de codificação, nome da função, OID ou qualquer combinação de tipo de codificação, nome da função e OID. Para cada função OID que corresponde aos critérios de seleção, uma função de retorno de chamada fornecida pelo aplicativo, pfnEnumOIDFunc, é chamada.

Sintaxe

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

Parâmetros

[in] dwEncodingType

Especifica o tipo de codificação a ser correspondido. Definir esse parâmetro como CRYPT_MATCH_ANY_ENCODING_TYPE corresponde a qualquer tipo de codificação. Observe que, se CRYPT_MATCH_ANY_ENCODING_TYPE não for especificado, um tipo de codificação de certificado ou mensagem será necessário. Se a palavra de baixa ordem que contém o tipo de codificação de certificado for diferente de zero, ela será usada; caso contrário, a palavra de alta ordem que contém o tipo de codificação de mensagem é usada. Se ambos forem especificados, o tipo de codificação de certificado na palavra de baixa ordem será usado.

Os tipos de codificação definidos no momento são:

CRYPT_ASN_ENCODING
X509_ASN_ENCODING
PKCS_7_ASN_ENCODING
CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

Nome de uma função para a qual uma pesquisa de correspondência que não diferencia maiúsculas de minúsculas é executada. Definir esse parâmetro como NULL faz com que uma correspondência seja encontrada para qualquer nome de função.

[in] pszOID

Se a palavra de alta ordem de pszOID for diferente de zero, pszOID especificará o identificador de objeto para o qual uma pesquisa de correspondência que não diferencia maiúsculas de minúsculas será executada. Se a palavra de alta ordem de pszOID for zero, pszOID será usado para corresponder a um identificador de objeto numérico. Definir esse parâmetro como NULL corresponde a qualquer identificador de objeto. Definir esse parâmetro como CRYPT_DEFAULT_OID restringe a enumeração apenas às funções padrão.

[in] dwFlags

Reservado para uso futuro e deve ser zero.

[in] pvArg

Um ponteiro para argumentos a serem passados para a função de retorno de chamada CRYPT_ENUM_OID_FUNCTION.

[in] pfnEnumOIDFunc

Um ponteiro para a função de retorno de chamada executada para cada função OID que corresponde aos parâmetros de entrada. Para obter detalhes, consulte CRYPT_ENUM_OID_FUNCTION.

Retornar valor

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.

Requisitos

Requisito	Valor
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