SHAllocShared-Funktion (shlwapi.h)

[SHAllocShared ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Ordnet ein Handle in einem angegebenen Prozess einer Kopie eines angegebenen Speicherblocks im aufrufenden Prozess zu.

Syntax

HANDLE SHAllocShared(
  [in, optional] const void *pvData,
  [in]           DWORD      dwSize,
  [in]           DWORD      dwProcessId
);

Parameter

[in, optional] pvData

Typ: const void*

Ein Zeiger auf den Speicherblock im aufrufenden Prozess, der kopiert werden soll. Sie können diesen Parameter auf NULL festlegen, wenn Sie einen Speicherblock freigeben möchten, ohne Daten in ihn zu kopieren.

[in] dwSize

Art: DWORD

Die Größe des Speicherblocks in Bytes, auf den von pvData verwiesen wird.

[in] dwProcessId

Art: DWORD

Die Prozess-ID des Prozesses, der den von pvData angegebenen Speicherblock gemeinsam nutzen wird.

Rückgabewert

Typ: HANDLE

Gibt ein Handle an den freigegebenen Arbeitsspeicher für den durch dwDestinationProcessId angegebenen Prozess zurück. Gibt NULL zurück, wenn der Fehler nicht erfolgreich ist.

Hinweise

Verwenden Sie SHFreeShared , um den Handle frei zu geben, wenn Sie fertig sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
DLL	Shlwapi.dll

Weitere Informationen

SHFreeShared

SHLockShared

SHUnlockShared