WinBioFree-Funktion (winbio.h)

Gibt Speicher frei, der der Clientanwendung durch einen früheren Aufruf einer Windows-Biometrischen Framework-API-Funktion zugewiesen wurde. Ab Windows 10, Build 1607, ist diese Funktion für die Verwendung mit einem mobilen Image verfügbar.

Syntax

HRESULT WinBioFree(
  [in] PVOID Address
);

Die Parameter

[in] Address

Adresse des zu löschenden Speicherblocks.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Bemerkungen

Mehrere Funktionen in der Windows-Biometrischen Framework-API weisen Speicher für die Clientanwendung zu und übergeben die Adresse dieses Speichers an den Client. Um Speicherverluste zu verhindern, müssen Sie WinBioFree aufrufen, um den Block zu löschen, wenn Sie die darin enthaltenen Informationen verwendet haben. Sie löschen den Speicher, indem Sie seine Adresse an WinBioFree übergeben. Sie finden die Adresse, indem Sie den durch den entsprechenden Parameter in den folgenden Funktionen angegebenen Zeiger aufheben.

Examples

Die folgende Funktion ruft WinBioEnumBiometricUnits auf, um die installierten biometrischen Sensoren aufgezählt zu werden, und sie ruft WinBioFree auf, um den von WinBioEnumBiometricUnits erstellten Speicher freizugeben. Verknüpfen Sie die statische Winbio.lib-Bibliothek, und fügen Sie die folgenden Headerdateien ein:

• 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;
}

Anforderungen

Siehe auch

WinBioCaptureSample

WinBioEnumBiometricUnits

WinBioEnumDatabases

WinBioEnumEnrollments

WinBioEnumServiceProviders