WinBioFree 函式 (winbio.h)

發行項
03/09/2024

釋放先前呼叫 Windows 生物特徵辨識架構 API 函式為用戶端應用程式配置的記憶體。從 Windows 10 組建 1607 開始，此函式可用於行動映射。

語法

HRESULT WinBioFree(
  [in] PVOID Address
);

參數

[in] Address

要刪除的記憶體區塊位址。

傳回值

如果函式成功，它會傳回S_OK。如果函式失敗，它會傳回 HRESULT 值，指出錯誤。可能的值包括 (但不限於) 下表中的這些值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

傳回碼	Description
E_POINTER	Address 參數不可為 NULL。

備註

Windows 生物特徵辨識架構 API 中的多個函式會配置用戶端應用程式的記憶體，並將該記憶體的位址傳遞至用戶端。若要防止記憶體流失，您必須呼叫 WinBioFree ，以在完成使用包含的信息時刪除區塊。您可以將記憶體位址傳遞至 WinBioFree 來刪除記憶體。您可以藉由取消參考下列每個函式中適當參數所指定的指標來尋找位址。

函式	參數	已配置的區塊類型
WinBioCaptureSample	範例	結構
WinBioEnumBiometricUnits	UnitSchemaArray	結構的陣列
WinBioEnumDatabases	StorageSchemaArray	結構的陣列
WinBioEnumEnrollments	SubFactorArray	一連串整數
WinBioEnumServiceProviders	BspSchemaArray	結構的陣列
EventCallBack	事件	結構
CaptureCallback	範例	結構

範例

下列函式會呼叫 WinBioEnumBiometricUnits 來列舉已安裝生物特徵辨識感測器，並呼叫 WinBioFree 來釋放 WinBioEnumBiometricUnits 所建立的記憶體。連結到Winbio.lib 靜態庫，並包含下列頭檔：

Windows.h
Stdio.h
Conio.h
Winbio.h

HRESULT EnumerateSensors( )
{
    HRESULT hr = S_OK;
    PWINBIO_UNIT_SCHEMA unitSchema = NULL;
    SIZE_T unitCount = 0;

    // Enumerate the installed biometric units.
    hr = WinBioEnumBiometricUnits( 
            WINBIO_TYPE_FINGERPRINT,        // Type of biometric unit
            &unitSchema,                    // Array of unit schemas
            &unitCount );                   // Count of unit schemas

    if (FAILED(hr))
    {
        wprintf_s(L"\nWinBioEnumBiometricUnits failed. hr = 0x%x\n", hr);
        goto e_Exit;
    }

e_Exit:

    // Free memory.
    if (unitSchema != NULL)
    {
        WinBioFree(unitSchema);
        unitSchema = NULL;
    }

    return hr;
}

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台	Windows
標頭	winbio.h (包含Winbio.h)
程式庫	Winbio.lib
Dll	Winbio.dll