Share via


CryptInstallOIDFunctionAddress

This function installs a set of callable OID function addresses.

BOOL WINAPI CryptInstallOIDFunctionAddress(
  HMODULE hModule,
  DWORD dwEncodingType,
  LPCSTR pszFuncName,
  DWORD cFuncEntry,
  CRYPT_OID_FUNC_ENTRY rgFuncEntry[ ],
  DWORD dwFlags
);

Parameters

  • hModule
    [in] Value that matches the hModule parameter passed to the DllMain function. This value prevents the DLL containing the function addresses from being unloaded by the CryptGetOIDFunctionAddress or CryptFreeOIDFunctionAddress function.

  • dwEncodingType
    [in] Specifies the encoding type to be matched. Currently, only X509_ASN_ENCODING is used; however, additional encoding types may be added in the future.

  • pszFuncName
    [in] Pointer to the null-terminated string that contains the name of the function set being installed.

  • cFuncEntry
    [in] Number of array elements in the rgFuncEntry parameter.

  • rgFuncEntry
    [in] Array of the CRYPT_OID_FUNC_ENTRY structure each containing an OID and the starting address of its correlated routine.

    Default functions are installed by setting the pszOID member of the CRYPT_OID_FUNC_ENTRY structure for their array element to CRYPT_DEFAULT_OID.

  • dwFlags
    [in] Bitmask of flags. By default, a new function set is installed at the end of the list of function sets. If this parameter is set to a value of CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG, the function set is installed at the beginning of the list.

Return Values

If the function succeeds, the return value is nonzero, or TRUE.

If the function fails, the return value is zero, or FALSE.

Remarks

The desktop platform supports the flag PKCS_7_ASN_ENCODING, but Windows CE does not and ignores the flag when it is specified.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Wincrypt.h.
Link Library: Crypt32.lib.

See Also

CryptEnumOIDInfo | CryptFindOIDInfo | CryptFreeOIDFunctionAddress | CryptGetDefaultOIDFunctionAddress | CryptGetOIDFunctionAddress | CryptInitOIDFunctionSet | DllMain | CRYPT_OID_FUNC_ENTRY

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.