UtilAssembleStringsWithAlloc 함수

UtilAssembleStringsWithAlloc 함수는 문자열을 할당하고 문자열 테이블에서 제공하는 문자열을 사용하여 형식을 지정합니다. 이 함수는 StringCchPrintf 를 사용하여 서식이 지정된 문자열을 만듭니다.

구문

HRESULT UtilAssembleStringsWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR InputFormat,
  _In_  LPCWSTR InputString,
  _In_  BOOLEAN AdditionalArgument,
  _In_  ULONG   AdditionalValue
);

매개 변수

버퍼 [out]

형식: LPWSTR*

새로 할당된 문자열을 배치할 위치입니다. 문자열이 더 이상 필요하지 않은 경우 CoTaskMemFree를 사용하여 해제해야 합니다.

BufferMax [in]

형식: UINT

Buffer에서 할당한 문자열에 허용되는 최대 문자 수입니다. 결과 형식이 지정된 문자열이 지정된 문자 수보다 길면 잘리고 null로 종료됩니다.

참고

이 매개 변수는 0으로 설정되지 않을 수 있습니다.

InputFormat [in]

형식: LPCWSTR

StringCchPrintf에 전달된 형식 매개 변수를 나타내는 문자열 테이블의 문자열 리소스입니다. MAKEINTRESOURCE를 사용하여 생성됩니다.

리소스 문자열 형식은 와이드 문자열을 사용하는 형식 매개 변수 또는 부호 없는 long 및 wide 문자열을 사용하는 형식 매개 변수를 지정해야 합니다.

InputString [in]

형식: LPCWSTR

형식 매개 변수의 와이드 문자열 대신 StringCchPrintf 에 전달된 인수를 나타내는 문자열 테이블의 문자열 리소스입니다. MAKEINTRESOURCE를 사용하여 생성됩니다.

AdditionalArgument [in]

형식: BOOLEAN

True이면 AdditionalValue 를 StringCchPrintf에 첫 번째 서식 인수로 전달해야 합니다. 그렇지 않으면 false입니다( InputString 으로 식별된 리소스 문자열만 전달됨).

AdditionalValue [in]

형식: ULONG

AdditionalArgument가 true인 경우 StringCchPrintf에 첫 번째 서식 인수로 전달할 값입니다.

반환 값

형식: HRESULT

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

요구 사항

추가 정보

UtilStringCopyWithAlloc

UtilLoadStringWithAlloc

StringCchPrintf

MAKEINTRESOURCE

CoTaskMemFree