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。

注意

此參數不能設定為零。

InputFormat [in]

類型： LPCWSTR

字串資源不在字串資料表中，代表傳遞至 StringCchPrintf的格式參數。 它是使用 MAKEINTRESOURCE建構的。

資源字串格式必須指定採用寬字元串的格式參數，或是採用不帶正負號長和寬字元串的格式參數。

InputString [in]

類型： LPCWSTR

字串資源不在字串資料表中，代表傳遞至 StringCchPrintf 的引數，以取代 format 參數中的寬字元串。 它是使用 MAKEINTRESOURCE建構的。

AdditionalArgument [in]

類型： BOOLEAN

True 是表示 如果 AdditionalValue 應該當做 StringCchPrintf的第一個格式化引數傳入;否則，false (，而且只會傳遞 InputString 所識別的資源字串) 。

AdditionalValue [in]

類型： ULONG

如果AdditionalArgument為 true，要當做第一個格式化引數傳遞至StringCchPrintf的值。

傳回值

類型： HRESULT

可能的傳回值包括但不限於下列各項。

規格需求

另請參閱

UtilStringCopyWithAlloc

UtilLoadStringWithAlloc

StringCchPrintf

MAKEINTRESOURCE

CoTaskMemFree