DosCallNmPipe |
DOS : Appel d'un nom de tuyau |
DOSCALLS.DLL |
os2.h |
Syntaxe
USHORT DosCallNmPipe(PSZ FileName, PBYTE InBuffer, USHORT InBufferLen, PBYTE OutBuffer, USHORT OutBufferLen, PUSHORT BytesOut, ULONG TimeOut);
|
Paramètres
Nom |
Description |
FileName |
Ce paramètre permet d'indiquer l'adresse de la chaîne de caractères ASCIZ du nom du tuyau étant ouvert. |
InBuffer |
Ce paramètre permet d'indiquer l'adresse du tampon à écrire dans le tuyau. |
InBufferLen |
Ce paramètre permet d'indiquer la taille en octets du tampon à écrire dans le tuyau. |
OutBuffer |
Ce paramètre permet d'indiquer l'adresse du tampon à lire du le tuyau. |
OutBufferLen |
Ce paramètre permet d'indiquer la taille en octets du tampon à lire du le tuyau. |
BytesOut |
Ce paramètre permet d'indiquer l'adresse de la variable où le système retourne le nombre d'octets actuellement lue. |
TimeOut |
Ce paramètre permet d'indiquer le délai maximum d'attente pour la disponibilité du tuyau. |
Retour
Valeur |
Constante |
Description |
0 |
NO_ERROR |
Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
11 |
ERROR_BAD_FORMAT |
Cette valeur permet d'indiquer qu'une erreur de mauvais format s'est produite. |
230 |
ERROR_BAD_PIPE |
Cette valeur permet d'indiquer qu'une erreur de mauvais tuyau s'est produite. |
231 |
ERROR_PIPE_BUSY |
Cette valeur permet d'indiquer qu'une erreur de tuyau occupé s'est produite. |
233 |
ERROR_PIPE_NOT_CONNECTED |
Cette valeur permet d'indiquer qu'une erreur de tuyau non connecté s'est produite. |
234 |
ERROR_MORE_DATA |
Cette valeur permet d'indiquer qu'une erreur de trop de données s'est produite. |
Description
Cette fonction permet d'effectuer un appel de traitement d'une transaction de «procédure d'appel» en utilisant un tuyau de message.
Remarques
- Cet appel est destiné à être utilisé uniquement sur les canaux de messages duplex. Si cet appel est émis pour un canal n'étant pas un canal de message duplex, la constante
ERROR_BAD_FORMAT est renvoyé.
- Cet appel a l'effet combiné sur un canal nommé des fonctions DosOpen, DosTransactNmPipe et
DosClose. Il fournit un moyen efficace de mettre en oeuvre des interfaces d'appel de procédure (RPC) locales et à distances entre les processus.
Voir également
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010