IStringTable：：AddString 方法 (mmc.h)

發行項
08/24/2023

IStringTable：：AddString方法可讓嵌入式管理單元將字串新增至嵌入式管理單元的字串資料表。

語法

HRESULT AddString(
  [in]  LPCOLESTR     pszAdd,
  [out] MMC_STRING_ID *pStringID
);

參數

[in] pszAdd

要加入字串資料表的字串。

[out] pStringID

新增至字串資料表之字串識別碼的指標。

傳回值

這個方法可以傳回其中一個值。

備註

字串資料表中的字串會進行參考計數。例如，將字串「My Text」新增至字串資料表會傳回識別碼，例如 1234。再次將「我的文字」新增至字串資料表會再次傳回識別碼 1234，而字串的內部參考計數將會遞增。對 IStringTable：:D eleteString或對 IStringTable：:D eleteAllStrings的單一呼叫，將需要從嵌入式管理單元的字串資料表完全移除「My Text」。

如果呼叫成功，IStringTable：：AddString會傳回非零字串識別碼。因此，嵌入式管理單元可以安全地使用 0 來指出未指派的識別碼。