SUBSCRIBE_REQUEST

 

The address of this structure passed back to applications when the media engine receives event subscription requests.

 

 

typedef struct

{

char *pSrcUserName;

char *pContactUserName;

char *pSrcHost;

DWORD SrcPort;

char *pEventName;

char *pEventParameter;

DWORD ExpiresSeconds;

int AcceptRequest;

NOTIFY_HANDLE NotifyHandle;

 

}SUBSCRIBE_REQUEST;

 

 

 

Members:

 

pSrcUserName

The name of the user sending the event subscription. This is the same as the "username" specified in the received SIP "From:" header.

 

pContactUserName

The alternate name of the user sending the event subscription. This is the same as the "username" specified in the received SIP "Contact:" header.
 

pSrcHost

The host address of the sender.

 

SrcPort

The port address of the sender.

 

pEventName

The null terminated name of the event the subscribing side ("other end") wants to receive.

 

pEventParameter

The null terminated event parameter string.

 

ExpiresSeconds

The time duration the other device wants to receive event notifications.

 

AcceptRequest

Important: Application code should set this to a non zero value if the event subscribe request is going to be accepted. If the application does not want to accept the subscribe request, this value must be set to zero.

 

NotifyHandle

If your application decides to accept an event subscription, use this handle to send notifications to the far end device. If your application accepts an event subscription, it takes ownership of this handle for future use. Your application must eventually close this handle by calling the CloseNotifyHandle API procedure when the subscription is terminated by the far end or when your application terminates.