_NamedPipes_CreateNamedPipe
Beschreibung anzeigen in
Erzeugt die Instanz einer Named Pipe (FIFO)
#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]]]]]]]]]]] )
Parameter
| $sName | Pipe-Name mit folgendem Format: \.\pipe\pipename. Der Namensteil der Pipe kann im Namen alle Zeichen beinhalten außer dem Backslash (\), gefolgt von Zahlen und Sonderzeichen. Der Pipe-Name kann bis zu 256 Zeichen lang sein. Bei Pipe-Namen wird die Groß- Kleinschreibung nicht berücksichtigt. |
| $iAccess | [optional] Die Pipe Zugriffsart. Eine der folgenden ist Pflicht: 0 - Die Daten der Pipe gehen nur vom Client zum Server (inbound) 1 - Die Daten der Pipe gehen nur vom Server zum Client (outbound) 2 - Die Pipe ist bio-direktional (duplex) |
| $iFlags | [optional] Die Pipe Flags. Kann eine der folgenden Kombinationen sein: 1 - Beim Versuch, mehrere Instanzen einer Pipe zu erstellen, wenn diese Option gesetzt ist, ist das Erzeugen der ersten Instanz erfolgreich, aber jeder weitere Versuch schlägt fehl. 2 - Asynchroner (überlappender) Modus ist aktiv. In diesem Modus können Funktionen, die länger dauernde Lese-, Schreib- und Verbindungsoperationen ausführen, sofort zurückkehren. 4 - Write-Through-Modus ist aktiv. Betrifft nur Schreiboperationen von Byte-Pipes und nur, wenn Client und Server auf unterschiedlichen Rechnern laufen. |
| $iACL | [optional] Sicherheits-ACL Flags. Kann eine der folgenden Kombinationen sein: 1 - Der Aufrufer hat Schreibzugriff auf die Benutzerzugriffssteuerung (DACL) der Pipe. 2 - Der Aufrufer hat Schreibzugriff auf die Besitzer der Pipe. 4 - Der Aufrufer hat Schreibzugriff auf die Systemzugriffssteuerung (SACL) der Pipe. |
| $iType | [optional] Pipe-Typ. Muss einer der Folgenden sein: 0 - Daten werden als Byte-Stream in die Pipe geschrieben. 1 - Daten werden als Nachrichten-Stream in die Pipe geschrieben. |
| $iRead | [optional] Pipe Lesemodus. Muss einer der Folgenden sein: 0 - Daten werden als Byte-Stream aus der Pipe gelesen. 1 - Daten werden als Nachrichten-Stream aus der Pipe gelesen. |
| $iWait | [optional] Pipe Wartemodus. Muss einer der Folgenden sein: 0 - Blockierender Modus. _WinAPI_ReadFile(), _WinAPI_WriteFile(), oder _NamedPipes_ConnectNamedPipe() kehren erst zurück, wenn die angestoßene Operation abgeschlossen ist. 1 - Nichtblockierender Modus. _WinAPI_ReadFile(), _WinAPI_WriteFile(), und _NamedPipes_ConnectNamedPipe() kehren immer sofort zurück. |
| $iMaxInst | [optional] Für diese Pipe kann die maximale Anzahl von Instanzen erstellt werden. |
| $iOutBufSize | [optional] Anzahl der Bytes, die für den Ausgabepuffer reserviert werden. |
| $iInpBufSize | [optional] Anzahl der Bytes, die für den Eingabepuffer reserviert werden. |
| $iDefaultTimeOut | [optional] Der übliche Timeout-Wert in Millisekunden. |
| $tSecurity | [optional] eine $tagSECURITY_ATTRIBUTES Struktur, die Sicherheitsrichtlinien der neuen benannten Pipe festlegt und die Vererbung des Handles regelt. Wenn $tSecurity 0 ist, erhält die benannte Pipe die Standard-Sicherheitsrichtlinie und das Handle kann nicht vererbt werden. Die Zugriffssteuerung (ACL) gewährt den Administratoren des lokalen Systems und dem Prozesseigner vollen Zugriff. Außerdem erhält jeder andere Benutzer Lesezugriff. |
Rückgabewert
| Erfolg: | Ein Handle zur Serverseite der Pipe-Instanz. |
| Fehler: | -1 |
Verwandte Funktionen
$tagSECURITY_ATTRIBUTES, _NamedPipes_ConnectNamedPipe, _NamedPipes_CreatePipe
Siehe auch
Suche nach CreateNamedPipe in der MSDN Bibliothek.