gfdConnectNmPipe( )

Description | Example

Name:	int gfdConnectNmPipe (int handle)
Inputs:	int handle	Valid pipe handle returned from gfdMakeNmPipe or gfdOpen.
Outputs:	none
Returns:	GFD_ACCESS_DENIED	· Pipe is not connected.
	GFD_BROKEN_PIPE	· Pipe was disconnected.
	GFD_INVALID_HANDLE	· Wrong pipe handle.
	GFD_NOT_INSTALLED	· Dispatcher is not running.
	GFD_SUCCESS	· Successful.
Includes:	gfdmsg.h gfdipc.h

Description

The gfdConnectNmPipe( ) function closes the server handle of a named pipe. If the client end of a named pipe is open, this call forces that end of the named pipe closed. The client receives an error value on the next attempt to access the pipe.

A client that is forced off a pipe by this function must close its end of the pipe using the gfdClose function.

Example

#define XXX_BASE    0x400  
#define XXX_gfdClose  (XXX_Base+81)  
intfaxChandle;  /* Fax channel handle from remote open */  
int AppHandle  
int status;  
int result;  
/* Close remote or fax channel side of pipe */  
status = gfdMakeNmPipe (*\\PIPE\\GFAX01î,ppHandle);  
status = gfdConnectNmPipe(appHandle);  
/* Will always return a vallue of 1 */  
status = gfdRemoteRequest(1,0,XXX_gfdOpen,0,0,  
     ì\\PIPE\\GFAX01î,size of(ì\\PIPE\\GFAX01î),&result);  
status = gfdConnectNmPipe (appHandle);  
/* now will retun GFD_SUCCESS*/

Click here to contact Dialogic Customer Engineering