Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

CryptMsgDuplicate function

The CryptMsgDuplicate function duplicates a cryptographic message handle by incrementing its reference count.

Syntax


HCRYPTMSG WINAPI CryptMsgDuplicate(
  _In_  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 CryptMsgClose function.

Remarks

CryptMsgDuplicate is used to increase the reference count on an HCRYPTMSG handle so that multiple calls to CryptMsgClose are required to actually release the handle.

Examples

For an example that uses this function, see Example C Program: Encoding and Decoding a Hashed Message.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wincrypt.h

Library

Crypt32.lib

DLL

Crypt32.dll

See also

Low-level Message Functions
Simplified Message Functions
CryptMsgClose

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.