AllocADsStr 함수(adshlp.h)

AllocADsStr 함수는 에 대한 메모리를 할당하고 지정된 문자열을 복사합니다.

구문

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

매개 변수

[in] pStr

형식: LPWSTR

복사할 null로 종료된 유니코드 문자열에 대한 포인터입니다.

반환 값

형식: LPWSTR

성공하면 함수는 NULL 이 아닌 포인터를 할당된 메모리에 반환합니다. pStr의 문자열은 이 버퍼에 복사되고 null로 종료됩니다. 호출자는 반환된 포인터를 FreeADsStr에 전달하여 더 이상 필요하지 않은 경우 이 메모리를 해제해야 합니다.

성공하지 못하면 NULL 을 반환합니다. ADsGetLastError를 호출하여 확장된 오류 상태 가져옵니다. 오류 코드 값에 대한 자세한 내용은 ADSI 오류 코드를 참조하세요.

설명

AllocADsStr 함수를 사용하는 방법을 보여 주는 코드 예제 및 자세한 내용은 ReallocADsStr을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 adshlp.h
라이브러리 Activeds.lib
DLL Activeds.dll

추가 정보

ADSI 함수

ADsGetLastError

FreeADsStr

ReallocADsStr