MSMQ Call Routines

MSMQGETSCONTEXT

Retrieves security information that is needed to authenticate messages.

Syntax
Arguments
Example

Syntax

CALL MSMQGETSCONTEXT(certStor, hContext, rc);

Specifies the name of the system certificate store to use to locate the desired external certificate. If NULL, then the internal security certificate that is provided by MSMQ is used. Generally, MY is used. The corresponding registry entry is:

HKEY_CURRENTUSER\Software\Microsoft\SystemCertificates\MY\Certificates

hContext

Numeric, output

Returns a 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

This example gets the security context from internal MSMQ certificate.

length msg $ 200;
hContext=0;
rc=0;
CALL MSMQGETSCONTEXT("", hContext, rc);
if rc ^= 0 then do;
   put 'MSMQGetSContext: failed';
   msg = sysmsg();
   put msg;
end;
else put 'MSMQGetSContext: succeeded';

Top of Page

MSMQGETSCONTEXT

Syntax

Arguments