CryptInstallOIDFunctionAddress

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function installs a set of callable OID function addresses.

Syntax

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 Value

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 operating system supports the flag PKCS_7_ASN_ENCODING, but Windows Embedded CE does not and ignores the flag when it is specified.

Requirements

See Also

Reference

CryptEnumOIDInfo
CryptFindOIDInfo
CryptFreeOIDFunctionAddress
CryptGetDefaultOIDFunctionAddress
CryptGetOIDFunctionAddress
CryptInitOIDFunctionSet
CRYPT_OID_FUNC_ENTRY

Other Resources

DllMain