SetMailslotInfo-Funktion (winbase.h)

  • Artikel

Legt den Timeoutwert fest, der vom angegebenen maillot für einen Lesevorgang verwendet wird.

Syntax

BOOL SetMailslotInfo(
  [in] HANDLE hMailslot,
  [in] DWORD  lReadTimeout
);

Parameter

[in] hMailslot

Ein Handle für ein Maillot. Die CreateMailslot-Funktion muss dieses Handle erstellen.

[in] lReadTimeout

Die Zeit, zu der ein Lesevorgang warten kann, bis eine Nachricht in das Maillot geschrieben wird, bevor ein Timeout auftritt, in Millisekunden. Die folgenden Werte haben eine besondere Bedeutung.

Wert Bedeutung
0
 Gibt sofort zurück, wenn keine Nachricht vorhanden ist. (Das System behandelt eine sofortige Rückgabe nicht als Fehler.)
MAILSLOT_WAIT_FOREVER
((DWORD)-1)
 Wartet ewig auf eine Nachricht.
 

Dieser Timeoutwert gilt für alle nachfolgenden Lesevorgänge und für alle geerbten Mailslot-Handles.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der anfängliche Timeoutwert, der von einem Maillot für einen Lesevorgang verwendet wird, wird normalerweise von CreateMailslot festgelegt, wenn das Mailslot erstellt wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CreateMailslot

GetMailslotInfo

Mailslot-Funktionen

Übersicht über Mailslots