RSC/MP Programming Manual

API Function Descriptions RscUmsCheck [RSCUCHK]
RscUmsCheck [RSCUCHK]
The RscUmsCheck function checks for unsolicited messages received for the session
identified by the ulSessionHandle parameter and retrieves the unsolicited message if
there is any. Upon successful completion of the function, the field referenced by
puBufferSize contains the actual number of characters stored in the buffer referenced
by pvBuffer. The va lue referenced by the puIoType parameter determines whether the
application running on the workstation must respond to the unsolicited message.
A value of RSC_UMS_WRITE indicates that the sender does not expect a response;
therefore, do no t reply to an unsolicited message of this type. A value of
RSC_UMS_WRITEREAD indicates that the sender is awaiting response. Issue a
response using the RscUmsReply function call.
See Section 8, Unsolicited Message Service, for more information about unsolicited
messages.
USHORT RscUmsCheck
(ULONG ulConnectionHandle /* in */
,ULONG ulSessionHandle /* in */
,SHORT *pnIoHandle /* out */
,VOID *pvBuffer /* out */
,USHORT *puBufferSize /* in / out */
,USHORT *puIoType /* out */
,USHORT *puReplyCount /* out */
);
ulConnectionHandle
The handle of an existing connection created through the RscConnect function
call.
ulSessionHandle
The handle of an existing session created through the RscBeginSession function
call.
pnIoHandle
A pointer to the field that receives the handle of the unsolicited message. This
handle is used when replying to the unsolicited message using the RscUmsReply
function.
pvBuffer
A pointer to the buffer that receives the data from the unsolicited message upon
successful completion of the RscUmsCheck function. The size of pvBuffer must
correspond to the size specified in the puBufferSize parameter.
HP NonStop Remote Server Call (RSC/MP) Programming Manual — 522360-006
10 - 35