다음을 통해 공유


PROPID_QM_ENCRYPTION_PK

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

(Read-only.) The PROPID_QM_ENCRYPTION_PK property indicates the public encryption key of the computer. This property is superseded by PROPID_QM_ENCRYPTION_PK_BASE in MSMQ 2.0 and later.

Property ID

PROPID_QM_ENCRYPTION_PK

Type Indicator

VT_VECTOR | VT_UI1

MQPROPVARIANT Field

caub

Property Value

Array of bytes that contains the public encryption key.

Remarks

The PROPID_QM_ENCRYPTION_PK property of the computer is set by Message Queuing when Message Queuing is installed.

Retrieving PROPID_QM_ENCRYPTION_PK

To retrieve the public encryption key of the computer, include PROPID_QM_ENCRYPTION_PK in the MQQMPROPS structure, and then call MQGetMachineProperties and examine the returned property value.

When specifying PROPID_QM_ENCRYPTION_PK in the MQQMPROPS structure, set its type indicator to VT_NULL. Message Queuing automatically allocates memory for an array of bytes that receives the public encryption key during the function call. A pointer to this array is stored in the pElem member of the caub field of the MQPROPVARIANT structure. After you no longer need this buffer, you must free the memory allocated for it using MQFreeMemory.

Equivalent COM Property

There is no equivalent COM property or method for retrieving the public encryption key of a computer.

Example Code

The following code fragment shows how PROPID_QM_ENCRYPTION_PK is specified in the MQQMPROPS structure.

aQMPropId[i] = PROPID_QM_ENCRYPTION_PK;      // Property identifier  
aQMPropVar[i].vt = VT_NULL;                  // Type indicator  

See Also

Queue Manager Properties
MQFreeMemory
MQGetMachineProperties
MQQMPROPS
PROPID_QM_ENCRYPTION_PK_BASE