msiViewFetch 函式 (msiquery.h)
MsiViewFetch 函式會從檢視擷取下一個循序記錄。 此函式會傳回應該使用 MsiCloseHandle 關閉的句柄。
語法
UINT MsiViewFetch(
[in] MSIHANDLE hView,
[out] MSIHANDLE *phRecord
);
參數
[in] hView
要從中擷取的檢視句柄。
[out] phRecord
所擷取記錄句柄的指標。
傳回值
請注意，在記憶體不足的情況下，此函式可能會引發STATUS_NO_MEMORY例外狀況。
備註
如果 MsiViewFetch 函式傳回ERROR_FUNCTION_FAILED，則可能不會先呼叫 MsiViewExecute 函式。 如果結果集中有更多數據列可用， MsiViewFetch 會傳回 phRecord 做為包含所要求數據行數據的記錄句柄，或 phRecord 為 0。 為了達到最大效能，應該使用相同的記錄來擷取所有擷取，或者應該從範圍外釋出記錄。
請注意，建議使用 PMSIHANDLE 類型的變數，因為安裝程式會在超出範圍時關閉 PMSIHANDLE 物件，而您必須呼叫 MsiCloseHandle 來關閉 MSIHANDLE 物件。 如需詳細資訊，請參閱 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 一節。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer |
| 目標平台 | Windows |
| 標頭 | msiquery.h |
| 程式庫 | Msi.lib |
| Dll | Msi.dll |