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 |