Condividi tramite


Funzione AllocADsStr (adshlp.h)

La funzione AllocADsStr alloca memoria per e copia una stringa specificata.

Sintassi

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

Parametri

[in] pStr

Tipo: LPWSTR

Puntatore a una stringa Unicode con terminazione null da copiare.

Valore restituito

Tipo: LPWSTR

In caso di esito positivo, la funzione restituisce un puntatore non NULL alla memoria allocata. La stringa in pStr viene copiata in questo buffer e terminata con null. Il chiamante deve liberare questa memoria quando non è più richiesto passando il puntatore restituito a FreeADsStr.

Restituisce NULL se non ha esito positivo. Chiamare ADsGetLastError per ottenere lo stato di errore esteso. Per altre informazioni sui valori del codice di errore, vedere Codici di errore ADSI.

Commenti

Per altre informazioni e un esempio di codice che illustra come usare la funzione AllocADsStr , vedere ReallocADsStr.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione adshlp.h
Libreria Activeds.lib
DLL Activeds.dll

Vedi anche

Funzioni ADSI

ADsGetLastError

FreeADsStr

ReallocADsStr