Compartilhar via

Função AllocADsStr (adshlp.h)

  • Artigo

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

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho adshlp.h
Biblioteca Activeds.lib
DLL Activeds.dll

Confira também

Funções ADSI

ADsGetLastError

FreeADsStr

ReallocADsStr