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
| 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 |