MSMQFREESCONTEXT

Frees the memory that is allocated by MSMQGETSCONTEXT.

Syntax

CALL MSMQFREESCONTEXT(hContext, rc);

Required Arguments

hContext
Numeric, input
Specifies the handle to the security context buffer that is allocated by MSMQ.
rc
Numeric, output
Provides the return code from the CALL routine. If an error occurs, then the return code is nonzero. A return code of -1 reflects a SAS internal error. Otherwise, it represents an MSMQ error code. You can use the SAS function SYSMSG() to obtain a textual description of the return code.

Example: Example

This example frees the security context buffer.
length msg $ 200;
rc=0;
CALL MSMQFREESCONTEXT(hContext, rc);
if rc ^= 0 then do;
   put 'MSMQFreeSContext: failed';
   msg = sysmsg();
   put msg;
end;
else put 'MSMQFreeSContext: succeeded';