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

另請參閱

一般數據庫存取函式

使用查詢