OS/2 NLS API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 Named Pipe APIs.

These APIs are included in your application by including the following definition in your application source file.

#define INCL_DOSNMPIPES

DosCreateNPipe

APIRET APIENTRY DosCreateNPipe(PSZ pszName, PHPIPE pHpipe, ULONG openmode,
                               ULONG pipemode, ULONG cbInbuf, ULONG cbOutbuf,
                               ULONG msec);

• Pipes are always opened in byte mode. Message mode is not supported.
• The argument pipemode is ignored for function but saved for DosQueryFHState.
• The argument cbInbuf and cbOutbuf are ignored.
• The argument openmode is ignored.
• The argument msec is ignored.

DosConnectNPipe

APIRET APIENTRY DosConnectNPipe(HPIPE hpipe);

• No need to do anything here except check for valid pipe handle.

DosDisConnectNPipe

APIRET APIENTRY DosDisConnectNPipe(HPIPE hpipe);

• No need to do anything here except check for valid pipe handle.

DosTransactNPipe

APIRET APIENTRY DosTransactNPipe(HPIPE hpipe, PVOID pOutbuf, ULONG cbOut,
                                 PVOID pInbuf, ULONG cbIn, PULONG pcbRead);

• None.

DosCallNPipe

APIRET APIENTRY DosCallNPipe(PSZ pszName, PVOID pInbuf, ULONG cbIn,
                             PVOID pOutbuf, ULONG cbOut, PULONG pcbActual,
                             ULONG msec);

• The argument msec is ignored.

DosQueryNPHState

APIRET APIENTRY DosQueryNPHState(HPIPE hpipe, PULONG pState);

• This function returns mostly static values.

DosWaitNPipe

APIRET APIENTRY DosWaitNPipe(PSZ pszName, ULONG msec);

• None.

DosSetNPipeSem

APIRET APIENTRY DosSetNPipeSem(HPIPE hpipe, HSEM hsem, ULONG key);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosPeekNPipe

APIRET APIENTRY DosPeekNPipe(HPIPE hpipe, PVOID pBuf, ULONG cbBuf,
                             PULONG pcbActual, PAVAILDATA pAvail,
                             PULONG pState);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryNPipeInfo

APIRET APIENTRY DosQueryNPipeInfo(HPIPE hpipe, ULONG infolevel, PVOID pBuf,
                                  ULONG cbBuf);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryNPipeSemState

APIRET APIENTRY DosQueryNPipeSemState(HSEM hsem, PPIPESEMSTATE pnpss,
                                      ULONG cbBuf);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosRawReadNPipe

APIRET APIENTRY DosRawReadNPipe(PSZ pszName, ULONG cb, PULONG pLen,
                                PVOID pBuf);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosRawWriteNPipe

APIRET APIENTRY DosRawWriteNPipe(PSZ pszName, ULONG cb);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetNPHState

APIRET APIENTRY DosSetNPHState(HPIPE hpipe, ULONG state);

• This function is not supported and always returns ERROR_ACCESS_DENIED.