WinBioFree 함수(winbio.h)

Windows 생체 인식 프레임워크 API 함수에 대한 이전 호출을 통해 클라이언트 애플리케이션에 할당된 메모리를 해제합니다. Windows 10 빌드 1607부터 이 함수를 모바일 이미지와 함께 사용할 수 있습니다.

구문

HRESULT WinBioFree(
  [in] PVOID Address
);

매개 변수

[in] Address

삭제할 메모리 블록의 주소입니다.

반환 값

함수가 성공하면 S_OK를 반환합니다. 함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

설명

Windows 생체 인식 프레임워크 API의 여러 함수는 클라이언트 애플리케이션에 대한 메모리를 할당하고 해당 메모리의 주소를 클라이언트에 전달합니다. 메모리 누수 방지를 위해 WinBioFree 를 호출하여 포함된 정보를 사용하여 블록을 삭제해야 합니다. WinBioFree에 주소를 전달하여 메모리를 삭제합니다. 다음 각 함수에서 적절한 매개 변수로 지정된 포인터를 참조 해제하여 주소를 찾을 수 있습니다.

예제

다음 함수는 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;
}

요구 사항

추가 정보

WinBioCaptureSample

WinBioEnumBiometricUnits

WinBioEnumDatabases

WinBioEnumEnrollments

WinBioEnumServiceProviders