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 加上一個字元。

傳回碼	Description
TRUE	已成功重新配置字串。
FALSE	記憶體不足。

配置新的字串、將傳入字串中的 len 字元複製到其中，然後附加 Null 字元。釋放 pbstr 目前參考的 BSTR，並重設 pbstr 以指向新的 BSTR。如果 psz 為 null，則會配置長度為 len 的字串，但不會初始化。

psz 字串可以包含內嵌的 Null 字元，而且不需要以 Null 結尾。

如果此函式傳遞NULL指標，將會發生存取違規，而且程式將會當機。您必須負責保護此函式免於 NULL 指標。