UDF > NamedPipes >


_NamedPipes_CreateNamedPipe

Cr�e une instance d'un pipe nomm�

#include <NamedPipes.au3>
_NamedPipes_CreateNamedPipe ( $sName [, $iAccess = 2 [, $iFlags = 2 [, $iACL = 0 [, $iType = 1 [, $iRead = 1 [, $iWait = 0 [, $iMaxInst = 25 [, $iOutBufSize = 4096 [, $iInpBufSize = 4096 [, $iDefaultTimeout = 5000 [, $tSecurity = 0]]]]]]]]]]] )

Param�tres

$sName Nom du pipe avec le format suivant: \\.\pipe\pipename.
La partie 'pipename' du nom peut comporter n'importe quel caract�re autre qu'une barre oblique inverse, y compris les nombres et les caract�res sp�ciaux.
La cha�ne 'pipe' peut avoir jusqu'� 256 caract�res.
Les noms de pipe ne sont pas sensibles � la casse.
$iAccess [optionnel] Le mode d'acc�s au Pipe. Doit �tre l'un des suivants:
    0 - Le flux de donn�es dans le pipe va uniquement du client vers le serveur (entrant)
    1 - Le flux de donn�es dans le pipe va uniquement du serveur vers le client (sortant)
    2 - Le pipe est bidirectionnel (duplex)
$iFlags [optionnel] Les options du pipe. Peut prendre pour valeur une combinaison des valeurs suivantes:
    1 - Si vous tentez de cr�er plusieurs instances d'un pipe avec ce flag, la cr�ation de la premi�re instance r�ussit, mais la cr�ation de l'instance suivante �choue.
    2 - Active le mode recouvrement. Si ce mode est activ�, les fonctions des op�rations de lecture, d'�criture et de connexion qui peuvent prendre un temps significatif pour s'achever peuvent retourner imm�diatement.
    4 - Active le mode �criture. Ce mode ne concerne que les op�rations d'�criture sur les pipes de type octet et seulement lorsque le client et le serveur sont sur des ordinateurs diff�rents.
$iACL [optionnel] Options de s�curit� ACL. Peut �tre n'importe quelle combinaison des options suivantes:
    1 - L'appelant aura acc�s en �criture � l'ACL discr�tionnaire du Pipe nomm�
    2 - L'appelant aura acc�s en �criture au propri�taire du pipe nomm�
    4 - L'appelant aura acc�s en �criture � l'ACL de s�curit� du pipe nomm�
$iType [optionnel] Mode type de pipe. Doit �tre l'un des suivants :
    0 - Les donn�es sont �crites dans le pipe comme un flux d'octets
    1 - Les donn�es sont �crites dans le pipe comme un flux de messages
$iRead [optionnel] Mode de lecture du pipe. Doit �tre l'un des suivants:
    0 - Les donn�es sont lues � partir du pipe comme un flux d'octets
    1 - Les donn�es sont lues � partir du pipe comme un flux de messages
$iWait [optionnel] Mode d'attente du pipe. Doit �tre l'un des suivants:
    0 - Active le mode blocage. Lorsque le handle du pipe est sp�cifi� dans _WinAPI_ReadFile(), _WinAPI_WriteFile(), ou _NamesPipes_ConnectNamedPipe, l'op�ration n'est pas termin�e jusqu'� ce que toutes les donn�es soient lues, toutes les donn�es �crites, ou un client connect�.
    1 - Active le mode non bloquant. _WinAPI_ReadFile(), _WinAPI_WriteFile(), et _NamesPipes_ConnectNamedPipe retournent toujours imm�diatement.
$iMaxInst [optionnel] Nombre maximal d'instances qui peuvent �tre cr��es pour ce pipe
$iOutBufSize [optionnel] Nombre d'octets � r�server pour le tampon de sortie
$iInpBufSize [optionnel] Nombre d'octets � r�server pour le tampon d'entr�e
$iDefaultTimeOut [optionnel] Valeur par d�faut du hors d�lai, en millisecondes
$tSecurity [optionnel] Une structure $tagSECURITY_ATTRIBUTES qui sp�cifie un descripteur de s�curit� pour le nouveau pipe nomm� et d�termine si les processus enfants peuvent h�riter du handle retourn�.
Si $tSecurity est 0, le pipe nomm� obtient un descripteur de s�curit� par d�faut et le handle ne peut pas �tre h�rit�e.
Les ACLs dans le descripteur de s�curit� par d�faut pour un pipe nomm� accordent un contr�le total aux administrateurs de compte LocalSystem et au propri�taire du cr�ateur.
Ils accordent �galement un acc�s en lecture aux membres du groupe Everyone et un compte anonyme.

Valeur de retour

Succ�s: Retourne le handle de la fin du serveur d'une instance du pipe nomm�.
�chec: Retourne -1.

En relation

$tagSECURITY_ATTRIBUTES, _NamedPipes_ConnectNamedPipe, _NamedPipes_CreatePipe

Voir aussi

Consultez CreateNamedPipe dans la librairie MSDN.