IStringTable：：AddString 方法 (mmc.h)

项目
08/24/2023

IStringTable：：AddString 方法允许管理单元向管理单元的字符串表添加字符串。

语法

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

parameters

[in] pszAdd

要添加到字符串表的字符串。

[out] pStringID

指向添加到字符串表的字符串 ID 的指针。

返回值

此方法可以返回其中一个值。

注解

对字符串表中的字符串进行引用计数。例如，将字符串“My Text”添加到字符串表将返回 ID，例如 1234。再次将“My Text”添加到字符串表将再次返回 ID 1234，字符串的内部引用计数将递增。需要对 IStringTable：:D eleteString 进行两次调用或对 IStringTable：:D eleteAllStrings 的一次调用，才能从管理单元的字符串表中完全删除“My Text”。

如果对 IStringTable：：AddString 的调用成功，则返回非零字符串 ID。因此，管理单元可以安全地使用 0 来指示未分配的 ID。