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

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

Consulte también

Funciones ADSI

ADsGetLastError

FreeADsStr

ReallocADsStr