共用方式為


WinBioFree 函式 (winbio.h)

釋放先前呼叫 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

另請參閱

WinBioCaptureSample

WinBioEnumBiometricUnits

WinBioEnumDatabases

WinBioEnumEnrollments

WinBioEnumServiceProviders