ResUtilDupParameterBlock-Funktion (resapi.h)
Führt eine memberweise Kopie der Daten von einem Parameterblock in einen anderen aus.
Syntax
DWORD ResUtilDupParameterBlock(
[out] LPBYTE pOutParams,
[in] const LPBYTE pInParams,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable
);
Parameter
[out] pOutParams
Zeiger auf den duplizierten Parameterblock.
[in] pInParams
Zeiger auf den ursprünglichen Parameterblock.
[in] pPropertyTable
Zeiger auf ein Array von RESUTIL_PROPERTY_ITEM Strukturen, die Eigenschaften im ursprünglichen Parameterblock beschreiben.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück.
Hinweise
ResUtilDupParameterBlock kopiert Daten nur für Parameterblockmember, auf die im pPropertyTable-Eingabeparameter verwiesen wird. Wenn eine Variable im Eingabeparameterblock ein Zeiger ist, wird der Speicher für die Daten mit der Funktion LocalAlloc zugeordnet. Sie sollten die Zuordnung dieses Arbeitsspeichers aufheben, indem Sie entweder LocalFree für jede Zeigervariable im Ausgabeparameterblock oder ResUtilFreeParameterBlock aufrufen. Stellen Sie sicher, dass Sie die Speicherzuordnung aufheben, unabhängig davon, ob ResUtilDupParameterBlock erfolgreich ist oder fehlschlägt. Weitere Informationen finden Sie unter Verwenden von Parameterblöcken und Verwenden von Listen und Tabellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |
| Bibliothek | ResUtils.lib |
| DLL | ResUtils.dll |