Função AllocADsStr (adshlp.h)

A função AllocADsStr aloca memória para e copia uma cadeia de caracteres especificada.

Sintaxe

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

Parâmetros

[in] pStr

Tipo: LPWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo a ser copiada.

Retornar valor

Tipo: LPWSTR

Quando bem-sucedida, a função retorna um ponteiro não NULL para a memória alocada. A cadeia de caracteres em pStr é copiada para esse buffer e terminada em nulo. O chamador deve liberar essa memória quando ela não for mais necessária passando o ponteiro retornado para FreeADsStr.

Retorna NULL se não for bem-sucedido. Chame ADsGetLastError para obter o erro estendido status. Para obter mais informações sobre valores de código de erro, consulte Códigos de erro ADSI.

Comentários

Para obter mais informações e um exemplo de código que mostra como usar a função AllocADsStr , consulte ReallocADsStr.

Requisitos

Confira também

Funções ADSI

ADsGetLastError

FreeADsStr

ReallocADsStr