Función ReallocADsMem (adshlp.h)

Artículo
03/05/2024

La función ReallocADsMem reasigna y copia un bloque de memoria existente.

Sintaxis

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

Parámetros

[in] pOldMem

Tipo: LPVOID

Puntero a la memoria que se va a copiar. ReallocADsMem liberará esta memoria con FreeADsMem después de haberla copiado. Si no se puede asignar memoria adicional, esta memoria no se libera. Esta memoria debe haberse asignado con la función AllocADsMem, AllocADsStr, ReallocADsMem o ReallocADsStr .

El autor de la llamada debe liberar esta memoria cuando ya no sea necesario pasando este puntero a FreeADsMem.

[in] cbOld

Tipo: DWORD

Tamaño, en bytes, de la memoria que se va a copiar.

[in] cbNew

Tipo: DWORD

Tamaño, en bytes, de la memoria que se va a asignar.

Valor devuelto

Tipo: LPVOID

Cuando se ejecuta correctamente, la función devuelve un puntero a la nueva memoria asignada. De lo contrario, devuelve NULL.

Comentarios

Si cbNew es menor que cbOld, la memoria existente se trunca para ajustarse al nuevo tamaño de memoria.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar ReallocADsMem para ampliar una cadena.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	adshlp.h
Library	Activeds.lib
Archivo DLL	Activeds.dll