다음을 통해 공유


IStringTable::AddString 메서드(mmc.h)

IStringTable::AddString 메서드를 사용하면 스냅인에서 스냅인의 문자열 테이블에 문자열을 추가할 수 있습니다.

구문

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

매개 변수

[in] pszAdd

문자열 테이블에 추가할 문자열입니다.

[out] pStringID

문자열 테이블에 추가된 문자열의 ID에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

문자열 테이블의 문자열은 참조 횟수가 계산됩니다. 예를 들어 문자열 테이블에 "내 텍스트" 문자열을 추가하면 ID(예: 1234)가 반환됩니다. 문자열 테이블에 "내 텍스트"를 두 번 추가하면 ID가 1234로 다시 반환되고 문자열의 내부 참조 수가 증가합니다. 스냅인의 문자열 테이블에서 "내 텍스트"를 완전히 제거하려면 IStringTable::D eleteString에 대한 두 번의 호출 또는 IStringTable::D eleteAllStrings에 대한 단일 호출이 필요합니다.

IStringTable::AddString 은 호출이 성공한 경우 0이 아닌 문자열 ID를 반환합니다. 따라서 스냅인은 0을 사용하여 할당되지 않은 ID를 안전하게 나타낼 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 mmc.h
DLL Mmcndmgr.dll

참고 항목

IStringTable

IStringTable::D eleteAllStrings

IStringTable::D eleteString