Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 hModuleparameter passed to the DllMainfunction. This value prevents the DLL containing the function addresses from being unloaded by the CryptGetOIDFunctionAddressor CryptFreeOIDFunctionAddressfunction.

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 rgFuncEntryparameter.

rgFuncEntry

[in] Array of the CRYPT_OID_FUNC_ENTRYstructure each containing an OID and the starting address of its correlated routine.

Default functions are installed by setting the pszOIDmember of the CRYPT_OID_FUNC_ENTRYstructure 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

Header wincrypt.h
Library crypt32.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also