SysReAllocStringLen 함수(oleauto.h)

  • 아티클

이전 BSTR에서 지정된 수의 문자를 포함하는 새 BSTR을 만들고 이전 BSTR을 해제합니다.

구문

INT SysReAllocStringLen(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz,
  [in]           unsigned int  len
);

매개 변수

[in, out] pbstr

이전에 할당된 문자열입니다.

[in, optional] psz

len 문자를 복사할 문자열 또는 문자열을 초기화되지 않은 상태로 유지하기 위한 NULL입니다.

[in] len

복사할 문자 수입니다. null 문자는 나중에 배치되어 총 len과 1 개의 문자를 할당합니다.

반환 값

반환 코드 설명
TRUE
 문자열이 다시 할당되었습니다.
FALSE
 메모리가 부족합니다.

설명

새 문자열을 할당하고 전달된 문자열의 len 문자를 복사한 다음 null 문자를 추가합니다. pbstr에서 현재 참조하는 BSTR을 해제하고 새 BSTR을 가리키도록 pbstr을 다시 설정합니다. psz가 null이면 길이 len 문자열이 할당되지만 초기화되지는 않습니다.

psz 문자열은 포함된 null 문자를 포함할 수 있으며 null로 끝날 필요가 없습니다.

이 함수가 NULL 포인터를 전달하면 액세스 위반이 발생하며 프로그램이 충돌합니다. NULL 포인터로부터 이 함수를 보호하는 것은 사용자의 책임입니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 oleauto.h
라이브러리 OleAut32.lib
DLL OleAut32.dll

추가 정보

문자열 조작 함수