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 duplicates a cryptographic message handle by incrementing its reference count.

Syntax 

HCRYPTMSG WINAPI CryptMsgDuplicate(
  HCRYPTMSG 
hCryptMsg
);

Parameters

hCryptMsg

[in] Handle of the cryptographic message to be duplicated. Duplication is done by incrementing the reference count of the message. A copy of the message is not made.

Return Value

The returned handle is the same as the handle input. A copy of the message is not created. When you have finished using the duplicated message handle, decrease the reference count by calling the CryptMsgClosefunction.

Remarks

CryptMsgDuplicateis used to increase the reference count on an HCRYPTMSGhandle so that multiple calls to CryptMsgCloseare required to actually release the handle.

Requirements

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

See Also