ReallocADsMem-Funktion (adshlp.h)

Artikel
03/01/2024

Mit der Funktion ReallocADsMem wird ein vorhandener Speicherblock neu zugeordnet und kopiert.

Syntax

LPVOID ReallocADsMem(
  [in] LPVOID pOldMem,
  [in] DWORD  cbOld,
  [in] DWORD  cbNew
);

Parameter

[in] pOldMem

Typ: LPVOID

Zeiger auf den zu kopierenden Speicher. ReallocADsMem gibt diesen Speicher mit FreeADsMem frei, nachdem er kopiert wurde. Wenn kein zusätzlicher Arbeitsspeicher zugewiesen werden kann, wird dieser Arbeitsspeicher nicht freigegeben. Dieser Arbeitsspeicher muss mit der Funktion AllocADsMem, AllocADsStr, ReallocADsMem oder ReallocADsStr zugeordnet worden sein.

Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem er diesen Zeiger an FreeADsMem übergibt.

[in] cbOld

Art: DWORD

Größe des zu kopierenden Arbeitsspeichers in Bytes.

[in] cbNew

Art: DWORD

Größe des zu zuweisenden Arbeitsspeichers in Bytes.

Rückgabewert

Typ: LPVOID

Bei erfolgreicher Ausführung gibt die Funktion einen Zeiger auf den neuen zugeordneten Speicher zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

Wenn cbNew kleiner als cbOld ist, wird der vorhandene Arbeitsspeicher abgeschnitten, um der neuen Speichergröße zu entsprechen.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie ReallocADsMem verwenden, um eine Zeichenfolge zu vergrößern.

LPWSTR pwszPrefix = L"LDAP://"
DWORD dwOldSize = (lstrlenW(pwszPrefix) + 1) * sizeof(WCHAR);

LPWSTR pwszADsPath = (LPWSTR)AllocADsMem(dwOldSize);
if(pwszADsPath)
{
    LPWSTR pwszDN = L"DC=fabrikam,DC=com";

    wcsncpy_s(pwszADsPath, pwszPrefix); // Path becomes "LDAP://"
    wprintf(L"path = %s\n", pwszADsPath);

    DWORD dwNewSize = (lstrlenW(pwszPrefix) + lstrlenW(pwszDN) + 1) * sizeof(WCHAR);
    
    /*
    If successful, this will free the old path buffer, so it does not have to be 
    freed manually. But if it fails, the original memory still exists, so the 
    reallocated memory pointer is temporarily placed in another variable.
    */
    LPWSTR pwszNewPath = (LPWSTR)ReallocADsMem(pwszADsPath, dwOldSize, dwNewSize);
    if(pwszNewPath)
    {
        pwszADsPath = pwszNewPath;

        // Path is still "LDAP://"
        wcsncat_s(pwszADsPath, pwszDN);

        // Path is "LDAP://DC=fabrikam,DC=com"
        wprintf(L"path = %s\n", pwszADsPath);
    }
    else
    {
        wprintf(L"Unable to allocate additional memory.");
    }

    // Free remaining memory.
    FreeADsMem(pwszADsPath);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	adshlp.h
Bibliothek	Activeds.lib
DLL	Activeds.dll