SHAllocShared-Funktion (shlwapi.h)

[SHAllocShared steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Weist 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
);

Die 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 pvData verweist.

[in] dwProcessId

Art: DWORD

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

Rückgabewert

Typ: HANDLE

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

Bemerkungen

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

Anforderungen

Siehe auch

SHFreeShared

SHLockShared

SHUnlockShared