Función AllocADsStr (adshlp.h)

La función AllocADsStr asigna memoria para y copia una cadena especificada.

Sintaxis

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

Parámetros

[in] pStr

Tipo: LPWSTR

Puntero a una cadena Unicode terminada en null que se va a copiar.

Valor devuelto

Tipo: LPWSTR

Cuando se ejecuta correctamente, la función devuelve un puntero distinto de NULL a la memoria asignada. La cadena de pStr se copia en este búfer y termina en null. El autor de la llamada debe liberar esta memoria cuando ya no sea necesario pasando el puntero devuelto a FreeADsStr.

Devuelve NULL si no se ejecuta correctamente. Llame a ADsGetLastError para obtener el estado de error extendido. Para obtener más información sobre los valores de código de error, vea Códigos de error adsi.

Comentarios

Para obtener más información y un ejemplo de código que muestra cómo usar la función AllocADsStr , vea ReallocADsStr.

Requisitos

Consulte también

Funciones ADSI

ADsGetLastError

FreeADsStr

ReallocADsStr