INamedEntityCollector：：Add 方法 (structuredquery.h)

將單一 (可能) 具名實體新增至這個 INamedEntityCollector 集合，如所剖析之輸入字串的標記化範圍所識別。

語法

HRESULT Add(
  [in] ULONG                  beginSpan,
  [in] ULONG                  endSpan,
  [in] ULONG                  beginActual,
  [in] ULONG                  endActual,
  [in] IEntity                *pType,
  [in] LPCWSTR                pszValue,
  [in] NAMED_ENTITY_CERTAINTY certainty
);

參數

[in] beginSpan

類型： ULONG

整體標記範圍的開頭，包括任何前置引號。

[in] endSpan

類型： ULONG

整體標記範圍的結尾，包括任何尾端引號。

[in] beginActual

類型： ULONG

識別潛在具名實體之令牌範圍的一部分開頭。

[in] endActual

類型： ULONG

標記範圍的結尾，識別潛在的具名實體。

[in] pType

類型： IEntity*

具名實體的語意類型。

[in] pszValue

類型： LPCWSTR

實體的名稱做為字串。

[in] certainty

類型： NAMED_ENTITY_CERTAINTY

下列其中一個值：

值	資訊
NEC_LOW	這可能是這個具名實體，但建議使用其他辨識項。
NEC_MEDIUM	這可能是這個具名實體;可以使用它。
NEC_HIGH	這幾乎一定是這個具名實體;應該可以捨棄其他可能性。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

當查詢剖析器將輸入字串剖析成條件節點時，剖析器會叫用 IConditionGenerator 物件，然後叫用 INamedEntityCollector：：Add 以收集輸入字元串中可能的具名實體。 IConditionGenerator 對象必須針對它在輸入字串中辨識的每個潛在具名實體呼叫這個方法。 針對每個實體，條件產生器必須提供下列資訊：

• 其涵蓋的輸入字串部分
• 具名實體的語意類型
• 具名實體值的字串表示
• 輸入確實是具名實體的確定性層級

如果在輸入字串的解譯中使用具名實體，條件產生器的 GenerateForLeaf 方法將會叫用值字串做為其中一個自變數。

在四個第一個自變數之間必須維護下列關聯性：beginSpan = beginActual endActual = <endSpan。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台	Windows
標頭	structuredquery.h
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0