Freigeben über


DeleteLogMarshallingArea-Funktion (clfsw32.h)

Löscht einen Marshallingbereich, der durch einen erfolgreichen Aufruf von CreateLogMarshallingArea erstellt wird.

Wenn Sie einen Marshallingbereich löschen, werden folgende Aktionen ausgeführt:

  • Leert das Protokoll, um ausstehende Protokoll-E/A-Blöcke frei zu geben.
  • Aufheben der Zuordnung aller Protokoll-E/A-Blöcke und ungültige Lesekontexte
Der vom Common Log File System (CLFS) zugewiesene Arbeitsspeicher zum Erstellen des Marshallingkontexts wird wieder freigegeben, wenn alle Lesekontexte beendet werden.
Hinweis Clients sollten einen Marshallingbereich nicht löschen, wenn vorgänge im Marshallingbereich ausstehen.
 

Syntax

CLFSUSER_API BOOL DeleteLogMarshallingArea(
  [in] PVOID pvMarshal
);

Parameter

[in] pvMarshal

Ein Zeiger auf den undurchsichtigen Marshallingkontext, der mithilfe der CreateLogMarshallingArea-Funktion zugeordnet wird.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die folgende Liste identifiziert die möglichen Fehlercodes:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile clfsw32.h
Bibliothek Clfsw32.lib
DLL Clfsw32.dll

Weitere Informationen

Allgemeine Protokolldateifunktionen

CreateLogMarshallingArea