Función CryptEnumOIDFunction (wincrypt.h)

La función CryptEnumOIDFunction enumera las funciones de identificador de objeto registrado (OID). Las funciones de OID enumeradas se pueden filtrar para incluir las identificadas por su tipo de codificación, nombre de función, OID o cualquier combinación de tipo de codificación, nombre de función y OID. Para cada función de OID que coincida con los criterios de selección, se llama a una función de devolución de llamada proporcionada por la aplicación, pfnEnumOIDFunc.

Sintaxis

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 el tipo de codificación que debe coincidir. Establecer este parámetro en CRYPT_MATCH_ANY_ENCODING_TYPE coincide con cualquier tipo de codificación. Tenga en cuenta que si no se especifica CRYPT_MATCH_ANY_ENCODING_TYPE, se requiere un tipo de codificación de mensaje o certificado. Si la palabra de orden inferior que contiene el tipo de codificación de certificado es distinto de cero, se utiliza; De lo contrario, se usa la palabra de orden superior que contiene el tipo de codificación del mensaje. Si se especifican ambos, se usa el tipo de codificación de certificado en la palabra de orden bajo.

Los tipos de codificación definidos actualmente son:

• CRYPT_ASN_ENCODING
• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING
• CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

Nombre de una función para la que se realiza una búsqueda de coincidencias sin distinción entre mayúsculas y minúsculas. Establecer este parámetro en NULL da como resultado una coincidencia que se encuentra para cualquier nombre de función.

[in] pszOID

Si la palabra de orden superior de pszOID es distinto de cero, pszOID especifica el identificador de objeto para el que se realiza una búsqueda de coincidencias sin distinción entre mayúsculas y minúsculas. Si la palabra de orden superior de pszOID es cero, pszOID se usa para coincidir con un identificador de objeto numérico. Establecer este parámetro en NULL coincide con cualquier identificador de objeto. Establecer este parámetro en CRYPT_DEFAULT_OID restringe la enumeración solo a las funciones predeterminadas.

[in] dwFlags

Reservado para uso futuro y debe ser cero.

[in] pvArg

Puntero a argumentos que se van a pasar a la función de devolución de llamada CRYPT_ENUM_OID_FUNCTION .

[in] pfnEnumOIDFunc

Puntero a la función de devolución de llamada que se ejecuta para cada función de OID que coincide con los parámetros de entrada. Para obtener más información, consulte CRYPT_ENUM_OID_FUNCTION.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero (TRUE).

Si se produce un error en la función, devuelve cero (FALSE). Para obtener información de error extendida, llame a GetLastError.

Requisitos

Consulte también

Funciones de compatibilidad con OID