Função CryptEnumOIDFunction (wincrypt.h)

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

Confira também

Funções de suporte do OID