Поделиться через


Метод IStringTable::AddString (mmc.h)

Метод IStringTable::AddString позволяет оснастке добавлять строку в таблицу строк оснастки.

Синтаксис

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

Параметры

[in] pszAdd

Строка, добавляемая в таблицу строк.

[out] pStringID

Указатель на идентификатор строки, добавленной в таблицу строк.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Комментарии

Строки в строковой таблице считаются ссылочными. Например, при добавлении строки "Мой текст" в таблицу строк возвращается идентификатор, например 1234. При добавлении "Мой текст" в таблицу строк во второй раз будет возвращен идентификатор 1234, а число внутренних ссылок для строки будет увеличено. Для полного удаления "Мой текст" из строковой таблицы оснастки потребуется два вызова IStringTable::D eleteAllStrings: :D eleteStrings или один вызов IStringTable::D eleteAllStrings.

IStringTable::AddString возвращает ненулевой идентификатор строки, если вызов выполнен успешно. Поэтому оснастки могут безопасно использовать 0 для указания неназначенных идентификаторов.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header mmc.h
DLL Mmcndmgr.dll

См. также раздел

IStringTable

IStringTable::D eleteAllStrings

IStringTable::D eleteString