Método IStringTable::AddString (mmc.h)
O método IStringTable::AddString permite que um snap-in adicione uma cadeia de caracteres à tabela de cadeia de caracteres do snap-in.
Sintaxe
HRESULT AddString(
[in] LPCOLESTR pszAdd,
[out] MMC_STRING_ID *pStringID
);
Parâmetros
[in] pszAdd
A cadeia de caracteres a ser adicionada à tabela de cadeia de caracteres.
[out] pStringID
Um ponteiro para a ID da cadeia de caracteres adicionada à tabela de cadeia de caracteres.
Valor retornado
Esse método pode retornar um desses valores.
Comentários
As cadeias de caracteres na tabela de cadeia de caracteres são contadas por referência. Por exemplo, adicionar a cadeia de caracteres "Meu Texto" à tabela de cadeia de caracteres retornará uma ID, digamos 1234. Adicionar "Meu Texto" à tabela de cadeia de caracteres uma segunda vez retornará uma ID de 1234 novamente e a contagem de referência interna para a cadeia de caracteres será incrementada. Duas chamadas para IStringTable::D eleteString ou uma única chamada para IStringTable::D eleteAllStrings serão necessárias para remover completamente "My Text" da tabela de cadeia de caracteres do snap-in.
IStringTable::AddString retornará uma ID de cadeia de caracteres diferente de zero se a chamada para ela tiver sido bem-sucedida. Portanto, os snap-ins podem usar 0 com segurança para indicar uma ID não atribuída.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |