共用方式為

CHString：：GetBuffer 方法 (chstring.h)

  • 發行項

[ CHString 類別是 WMI 提供者架構的一部分，現在被視為最終狀態，而且不會針對影響這些連結庫的非安全性相關問題使用進一步的開發、增強功能或更新。 MI API 應該用於所有新的開發。]

GetBuffer 方法會傳回 CHString 對象內部字元緩衝區的指標。

語法

LPWSTR  throw(CHeap_Exception) GetBuffer(
  int nMinBufLength
);

參數

nMinBufLength

字元緩衝區的大小下限。 這個值不包含 NULL 終止符的空間。

傳回值

物件 (NULL) 終止的字元緩衝區的 LPWSTR 指標。

備註

傳回 的 LPWSTR 不是 const ，因此允許直接修改 CHString 內容。

如果您使用 GetBuffer 傳回的指標來變更字串內容，您必須先呼叫 ReleaseBuffer ，才能使用任何其他 CHString 方法。

呼叫 ReleaseBuffer 之後，GetBuffer 傳回的位址可能無效，因為其他 CHString 作業可能會導致重新配置 CHString 緩衝區。 如果您未變更 CHString 字串的長度，則不會重新配置緩衝區。 當 CHString 物件終結時，會自動釋放緩衝區內存。

請注意，如果您自行追蹤字串長度，則不應該附加終止 的NULL 字元。 不過，當您使用 ReleaseBuffer 釋放緩衝區時，必須指定最終字串長度。 如果您附加終止 的 NULL 字元，您應該將 –1 作為長度傳遞至 ReleaseBuffer，這會在緩衝區上呼叫 wcslen 來判斷其長度。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 chstring.h (include FwCommon.h)
程式庫 FrameDyn.lib
Dll FrameDynOS.dll;FrameDyn.dll

另請參閱

CHString

CHString：：GetBufferSetLength

CHString：：ReleaseBuffer