建議使用 Visual Studio 2017

C28193

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

警告 C28193:變數的值必須被檢查。

這則函式提供的警告表示呼叫函式不會檢查指定的變數值。 傳回的值加註 _Check_return_ 附註,但是呼叫的函式不會使用此值,或在不檢查之下覆寫它。

這則警告與 C6031這則警告類似,不過只有在程式碼不測試、不檢查變數的值時,例如將它用於比較時,這個警告才會被回報。 簡單的地指派值並不會被視為用來避免警告的一次足夠的測試。 給函式之外的結果命名會被視為一次足夠的測試,不過應把它的結果與 _Check_return_標註在一起。

某些函式 (例如 strlen) 專門為其傳回值而存在,因此它能有 _Check_return_ 附註。 對這些函式而言,當傳回值是未使用時,程式碼剖析工具可以回傳這個警告。 這通常表示程式碼是無效的,例如它可能包含無法刪除的剩餘程式碼。 不過在某些罕見的情況,傳回值會刻意不使用。 最常見的例子是,是字串長度被傳回但實際上在其他測試之前並沒有被使用。 其他導致路徑模擬字串長度結束但未使用的測試。 發生這種情況時,程式碼可以是正確的,不過可能會降低執行效能。

有兩個主要策略來處理傳回值未使用的情況:

重新排列程式碼,以便讓字串長度沿著它需要的路徑傳回。

使用 #pragma的警告來隱藏警告--如果藉由重新排列程式碼,您可能會讓程式碼太複雜或不實用。

下列範例程式碼會產生這則警告:

IoGetDmaAdapter(pPDO, &DevDesc, &nMapRegs);  
...  

下列程式碼範例可以避免這則警告:

IoGetDmaAdapter(pPDO, &DevDesc, &nMapRegs);  
...  
if (nMapRegs < MIN_REQUIRED_MAPS) {  
...  
}  

顯示: