什麼是_Use_decl_annotations_含義

Question

我是SAL新手。 我想知道_Use_decl_annotations_的含義。我從MSDN學習過： http://msdn.microsoft.com/en-us/library/jj159529.aspx。

「可以在函數定義（也稱爲功能體） 就位在標題註釋的列表。當 _Use_decl_annotations_被使用，出現在一個在範圍內報頭中的註釋一起使用使用相同的函數，就好像它們也是在具有_Use_decl_annotations_ 註釋的定義中存在的 一樣。「

但是，我只是不能進去。何時以及爲什麼要在功能上使用它？

Answer 1

此註解指示靜態代碼分析工具在分析函數的定義時從聲明中獲取註釋。

這很有用，例如，當您實現一個API作爲標頭和二進制文件時。在這種情況下，您通常希望爲API的用戶提供與實現使用的SAL註釋相同的註釋。爲了防止註釋重複，公共頭文件中的函數聲明使用SAL註釋進行修飾，私有實現使用_Use_decl_annotations_來重複使用相同的註釋進行靜態代碼分析。