Skip to content

Latest commit

 

History

History
93 lines (68 loc) · 3.95 KB

nf-wincrypt-cryptfreeoidfunctionaddress.md

File metadata and controls

93 lines (68 loc) · 3.95 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:wincrypt.CryptFreeOIDFunctionAddress
CryptFreeOIDFunctionAddress function (wincrypt.h)
The CryptFreeOIDFunctionAddress function releases a handle returned by CryptGetOIDFunctionAddress or CryptGetDefaultOIDFunctionAddress by decrementing the reference count on the function handle.
CryptFreeOIDFunctionAddress
CryptFreeOIDFunctionAddress function [Security]
_crypto2_cryptfreeoidfunctionaddress
security.cryptfreeoidfunctionaddress
wincrypt/CryptFreeOIDFunctionAddress
security\cryptfreeoidfunctionaddress.htm
security
cacacff3-25b7-4ed4-885b-b4b0b326628f
12/05/2018
CryptFreeOIDFunctionAddress, CryptFreeOIDFunctionAddress function [Security], _crypto2_cryptfreeoidfunctionaddress, security.cryptfreeoidfunctionaddress, wincrypt/CryptFreeOIDFunctionAddress
wincrypt.h
Windows
Windows XP [desktop apps \| UWP apps]
Windows Server 2003 [desktop apps \| UWP apps]
Crypt32.lib
Crypt32.dll
Windows
19H1
CryptFreeOIDFunctionAddress
wincrypt/CryptFreeOIDFunctionAddress
c++
APIRef
kbSyntax
DllExport
Crypt32.dll
CryptFreeOIDFunctionAddress

CryptFreeOIDFunctionAddress function

-description

The CryptFreeOIDFunctionAddress function releases a handle returned by CryptGetOIDFunctionAddress or CryptGetDefaultOIDFunctionAddress by decrementing the reference count on the function handle. In some cases, the DLL file associated with the function is unloaded. For details, see Remarks.

-parameters

-param hFuncAddr [in]

Handle of the function previously obtained from a call to CryptGetOIDFunctionAddress or CryptGetDefaultOIDFunctionAddress.

-param dwFlags [in]

Reserved for future use and must be zero.

-returns

If the function succeeds, the function returns nonzero (TRUE).

If the function fails, it returns zero (FALSE).

-remarks

If the reference count becomes zero and a DLL is loaded for the function being freed, the DLL might be unloaded. If the DLL exports the DLLCanUnloadNow function, that function is called and its return is checked. An S_FALSE return from this function cancels the unloading of the DLL at this time. If the function returns S_TRUE or if the DLL does not export the DLLCanUnloadNow function, an unloading process is started. In this case, actual unloading is deferred for 15 seconds. If another CryptFreeOIDFunctionAddress or CryptGetDefaultOIDFunctionAddress that requires the DLL occurs before the 15 seconds elapse, the deferred unload process is canceled.

-see-also

CryptGetDefaultOIDFunctionAddress

CryptGetOIDFunctionAddress

DLLCanUnloadNow

OID Support Functions