NAME
irGetQKey - get the queue key of a specified process
SYNOPSIS
#include <irapi.h>
ir_key_t irGetQKey (char *name);
DESCRIPTION
The irGetQKey function returns the message key associated
with the process name. If name is NULL or has zero length,
irGetQKey function returns the message key of the caller.
It is assumed that name is a IRAPI application which has
been registered with the voice system via irRegister and
name matches the name with which it was registered.
The Qkey is the medium though which all non-channel based
message passing occurs.
EVENT
No event is generated as a result of a call to irGetQKey.
RETURN VALUE
If name is not null and is not zero length, the QKey of the
named process is returned if the request is successful. If
name is null or of zero length, the QKey of the calling pro-
cess is returned.
IRR_FAIL is returned if an error occurs.
ERROR
On error, irError is set as follows:
IRER_NOTFOUND if the name does not have a QKey
IRER_SYSERROR if a system or driver call failure occurs (see
irSysError for additional information)
SEE ALSO
irPostEvent(3IRAPI)
VERSION
This is version 8/31/00 of this man page.