专用池帮助程序函数

以下部分包含支持设置、标识和注册控制台项目所需的代码。

Targetver.h

此示例是为 Windows 7 及更高版本的操作系统创建的。

#pragma once
#ifndef _WIN32_WINNT            
#define _WIN32_WINNT NTDDI_WIN7 
#endif

stdafx.h

// stdafx.h : include file for standard system include files,
// or project specific include files that are used frequently but
// are changed infrequently
//

#pragma once

#include "targetver.h"

#define WIN32_LEAN_AND_MEAN     

#define _CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES 1

#include <stdio.h>
#include <tchar.h>

#include <windows.h>
#include <winbio.h>

#include <vector>
#include <string>

#ifndef ARGUMENT_PRESENT
#define ARGUMENT_PRESENT(x) (((x) != NULL))
#endif

#ifndef TSTRING
#ifdef _UNICODE
typedef std::wstring TSTRING;
#else
typedef std::string TSTRING;
#endif
#endif

#include "BioHelper.h"

BioHelper.h

/******************************************************************************
THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE.

Copyright (C) Microsoft.  All rights reserved.

This source code is only intended as a supplement to Microsoft Development
Tools and/or WinHelp documentation.  See these sources for detailed information
regarding the Microsoft samples programs.
******************************************************************************/

#pragma once

namespace BioHelper
{

typedef struct _POOL_CONFIGURATION {
    ULONG ConfigurationFlags;
    ULONG DatabaseAttributes;
    WINBIO_UUID DatabaseId;
    WINBIO_UUID DataFormat;
    WCHAR SensorAdapter[MAX_PATH];
    WCHAR EngineAdapter[MAX_PATH];
    WCHAR StorageAdapter[MAX_PATH];
} POOL_CONFIGURATION, *PPOOL_CONFIGURATION;

HRESULT
CreateCompatibleConfiguration(
    __in WINBIO_UNIT_SCHEMA* UnitSchema,
    __out POOL_CONFIGURATION* Configuration
    );

HRESULT
RegisterDatabase(
    __in WINBIO_STORAGE_SCHEMA* StorageSchema
    );

HRESULT
UnregisterDatabase(
    __in WINBIO_UUID *DatabaseId
    );

HRESULT
RegisterPrivateConfiguration(
    __in WINBIO_UNIT_SCHEMA* UnitSchema,
    __in POOL_CONFIGURATION* Configuration
    );

HRESULT
UnregisterPrivateConfiguration(
    __in WINBIO_UNIT_SCHEMA* UnitSchema,
    __in WINBIO_UUID *DatabaseId,
    __out bool *ConfigurationRemoved
    );

//
// Display routines...
//
// Caller must release returned message 
// buffer with LocalFree()
LPTSTR
ConvertErrorCodeToString(
    __in HRESULT ErrorCode
    );

LPCTSTR
ConvertSubFactorToString(
    __in WINBIO_BIOMETRIC_SUBTYPE SubFactor
    );

LPCTSTR
ConvertRejectDetailToString(
    __in WINBIO_REJECT_DETAIL RejectDetail
    );

}; // namespace BioHelper

Config.cpp

以下文件包含配置管理例程。

/******************************************************************************
THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE.

Copyright (C) Microsoft.  All rights reserved.

This source code is only intended as a supplement to Microsoft Development
Tools and/or WinHelp documentation.  See these sources for detailed information
regarding the Microsoft samples programs.
******************************************************************************/

/*
    Configuration management routines...
*/
#include "stdafx.h"

namespace BioHelper
{
//
// Forward declarations of local functions...
//
static HRESULT
CompareConfiguration(
    __in HKEY SourceConfigList,
    __in LPWSTR SourceConfigKey,
    __in POOL_CONFIGURATION* TargetConfig,
    __out bool *IsEqual
    );

static bool
ConvertStringToUuid(
    __in LPWSTR UuidString,
    __out WINBIO_UUID *Uuid
    );

static bool
ConvertUuidToString(
    __in WINBIO_UUID *Uuid,
    __out LPWSTR UuidStringBuffer,
    __in SIZE_T UuidStringBufferLength,
    __in bool IncludeBraces
    );

inline static bool
IsKeyNameNumeric(
    __in LPWSTR KeyName,
    __in DWORD KeyNameLength    // in characters
    )
{
    if (KeyNameLength == 0)
    {
        return false;
    }
    else
    {
        for (DWORD i = 0; i < KeyNameLength; ++i)
        {
            if (!iswdigit(KeyName[i]))
            {
                return false;
            }
        }
        return true;
    }
}

//-----------------------------------------------------------------------------

HRESULT
CreateCompatibleConfiguration(
    __in WINBIO_UNIT_SCHEMA* UnitSchema,
    __out POOL_CONFIGURATION* Configuration
    )
{
    HRESULT hr = S_OK;

    if (!ARGUMENT_PRESENT(UnitSchema) ||
        !ARGUMENT_PRESENT(Configuration))
    {
        return E_POINTER;
    }

    WINBIO_STORAGE_SCHEMA *storageArray = NULL;
    SIZE_T storageCount = 0;
    hr = WinBioEnumDatabases( WINBIO_TYPE_FINGERPRINT, &storageArray, &storageCount );
    if (FAILED(hr))
    {
        return hr;
    }

    std::wstring regPath = L"System\\CurrentControlSet\\Enum\\";
    regPath += UnitSchema->DeviceInstanceId;
    regPath += L"\\Device Parameters\\WinBio\\Configurations";

    HKEY configListKey = NULL;
    LONG regStatus = RegOpenKeyExW( 
                        HKEY_LOCAL_MACHINE, 
                        regPath.c_str(), 
                        0, 
                        KEY_READ, 
                        &configListKey 
                        );
    if (regStatus != ERROR_SUCCESS)
    {
        WinBioFree( storageArray );
        storageArray = NULL;
        storageCount = 0;
        return HRESULT_FROM_WIN32(regStatus);
    }

    DWORD subkeyIndex = 0;
    for (;;)
    {
        hr = S_OK;

        DWORD sensorMode = 0;
        ULONG configFlags = 0;
        DWORD systemSensor = 0;
        WINBIO_UUID dataFormat = {};
        ULONG attributes = 0;
        WCHAR sensorAdapter[MAX_PATH] = {};
        WCHAR engineAdapter[MAX_PATH] = {};
        WCHAR storageAdapter[MAX_PATH] = {};

        WCHAR subkeyName[MAX_PATH] = {};
        DWORD subkeyNameLength = ARRAYSIZE(subkeyName);
        regStatus = RegEnumKeyExW( 
                        configListKey, 
                        subkeyIndex, 
                        (LPWSTR)&subkeyName, 
                        &subkeyNameLength, 
                        NULL, 
                        NULL, 
                        NULL, 
                        NULL 
                        );
        if (regStatus != ERROR_SUCCESS)
        {
            if (regStatus == ERROR_NO_MORE_ITEMS)
            {
                hr = S_OK;
            }
            else
            {
                hr = HRESULT_FROM_WIN32(regStatus);
            }
            break;
        }

        if (IsKeyNameNumeric( subkeyName, subkeyNameLength ))
        {
            std::wstring configKeyPath = regPath + L"\\";
            configKeyPath += subkeyName;

            HKEY configKey = NULL;
            hr = HRESULT_FROM_WIN32(
                    RegOpenKeyExW(
                            HKEY_LOCAL_MACHINE, 
                            configKeyPath.c_str(), 
                            0, 
                            KEY_READ, 
                            &configKey 
                            ));
            if (SUCCEEDED(hr))
            {
                /*
                    Extract values in this configuration
                        SensorMode              - REG_DWORD
                        SystemSensor            - REG_DWORD
                        DatabaseId              - REG_SZ
                        SensorAdapterBinary     - REG_SZ
                        EngineAdapterBinary     - REG_SZ
                        StorageAdapterBinary    - REG_SZ
                */
                DWORD dataSize = sizeof(sensorMode);
                hr = HRESULT_FROM_WIN32(
                        RegGetValueW( 
                            configKey, 
                            NULL, 
                            L"SensorMode", 
                            RRF_RT_REG_DWORD, 
                            NULL, 
                            &sensorMode, 
                            &dataSize 
                            ));
                if (SUCCEEDED(hr))
                {
                    switch (sensorMode)
                    {
                    case WINBIO_SENSOR_BASIC_MODE:
                        configFlags = WINBIO_FLAG_BASIC;
                        break;

                    case WINBIO_SENSOR_ADVANCED_MODE:
                        configFlags = WINBIO_FLAG_ADVANCED;
                        break;

                    default:
                        configFlags = WINBIO_FLAG_DEFAULT;
                        break;
                    }
                }

                if (SUCCEEDED(hr))
                {
                    dataSize = sizeof(systemSensor);
                    hr = HRESULT_FROM_WIN32(
                            RegGetValueW( 
                                configKey, 
                                NULL, 
                                L"SystemSensor", 
                                RRF_RT_REG_DWORD, 
                                NULL, 
                                &systemSensor, 
                                &dataSize 
                                ));
                }

                if (SUCCEEDED(hr))
                {
                    WCHAR databaseIdString[40] = {};
                    dataSize = sizeof(databaseIdString);
                    hr = HRESULT_FROM_WIN32(
                            RegGetValueW( 
                                configKey, 
                                NULL, 
                                L"DatabaseId", 
                                RRF_RT_REG_SZ, 
                                NULL, 
                                &databaseIdString, 
                                &dataSize 
                                ));
                    if (SUCCEEDED(hr))
                    {
                        // convert string to GUID and find that GUID 
                        // in database list; capture corresponding 
                        // data-format GUID
                        WINBIO_UUID databaseIdGuid;
                        ConvertStringToUuid( databaseIdString, &databaseIdGuid );

                        bool databaseFound = false;
                        for (SIZE_T i = 0; i < storageCount; ++i)
                        {
                            if (storageArray[i].DatabaseId == databaseIdGuid)
                            {
                                dataFormat = storageArray[i].DataFormat;
                                attributes = storageArray[i].Attributes;
                                databaseFound = true;
                                break;
                            }
                        }
                        if (!databaseFound)
                        {
                            hr = WINBIO_E_DATABASE_CANT_FIND;
                        }
                    }
                }

                if (SUCCEEDED(hr))
                {
                    dataSize = sizeof(sensorAdapter);
                    hr = HRESULT_FROM_WIN32(
                            RegGetValueW( 
                                configKey, 
                                NULL, 
                                L"SensorAdapterBinary", 
                                RRF_RT_REG_SZ, 
                                NULL, 
                                &sensorAdapter, 
                                &dataSize 
                                ));
                }

                if (SUCCEEDED(hr))
                {
                    dataSize = sizeof(engineAdapter);
                    hr = HRESULT_FROM_WIN32(
                            RegGetValueW( 
                                configKey, 
                                NULL, 
                                L"EngineAdapterBinary", 
                                RRF_RT_REG_SZ, 
                                NULL, 
                                &engineAdapter, 
                                &dataSize 
                                ));
                }

                if (SUCCEEDED(hr))
                {
                    dataSize = sizeof(storageAdapter);
                    hr = HRESULT_FROM_WIN32(
                            RegGetValueW( 
                                configKey, 
                                NULL, 
                                L"StorageAdapterBinary", 
                                RRF_RT_REG_SZ, 
                                NULL, 
                                &storageAdapter, 
                                &dataSize 
                                ));
                }

                RegCloseKey(configKey);
                configKey = NULL;
            }
        }
        if (SUCCEEDED(hr))
        {
            if (systemSensor)
            {
                // copy results to output structure - we only want this
                // one if it's a derived from a system sensor config
                Configuration->ConfigurationFlags = configFlags;
                Configuration->DatabaseAttributes = attributes;
                Configuration->DataFormat = dataFormat;
                wcscpy_s( Configuration->SensorAdapter, MAX_PATH, sensorAdapter);
                wcscpy_s( Configuration->EngineAdapter, MAX_PATH, engineAdapter);
                wcscpy_s( Configuration->StorageAdapter, MAX_PATH, storageAdapter);
                break;
            }
            else
            {
                ++subkeyIndex;
            }
        }
        else
        {
            break;
        }
    }
    RegCloseKey( configListKey );
    configListKey = NULL;

    if (storageArray != NULL)
    {
        WinBioFree( storageArray );
        storageArray = NULL;
        storageCount = 0;
    }

    return hr;
}

//-----------------------------------------------------------------------------

HRESULT
RegisterDatabase(
    __in WINBIO_STORAGE_SCHEMA* StorageSchema
    )
{
    /*
        HKLM\System\CurrentControlSet\Services\WbioSrvc\Databases\{guid} -- NOTE THE CURLY BRACES
            Attributes          - REG_DWORD
            AutoCreate          - REG_DWORD (1)
            AutoName            - REG_DWORD (1)     -- this is reset to zero when the service creates the DB
            BiometricType       - REG_DWORD (8)     -- WINBIO_TYPE_FINGERPRINT
            ConnectionString    - REG_SZ ""
            Filepath            - REG_SZ ""         -- set by service
            Format              - REG_SZ "guid"     -- NOTE: *NO* CURLY BRACES
            InitialSize         - REG_DWORD (32)
    */
    HRESULT hr = S_OK;

    if (!ARGUMENT_PRESENT(StorageSchema))
    {
        return E_POINTER;
    }

    WCHAR databaseKeyName[MAX_PATH] = {};
    if (!ConvertUuidToString( 
            &StorageSchema->DatabaseId, 
            databaseKeyName, 
            ARRAYSIZE(databaseKeyName), 
            true
            ))
    {
        return E_INVALIDARG;
    }

    WCHAR dataFormat[MAX_PATH] = {};
    if (!ConvertUuidToString( 
            &StorageSchema->DataFormat, 
            dataFormat, 
            ARRAYSIZE(dataFormat), 
            false
            ))
    {
        return E_INVALIDARG;
    }

    HKEY databaseListKey = NULL;
    hr = HRESULT_FROM_WIN32(
            RegOpenKeyExW( 
                HKEY_LOCAL_MACHINE, 
                L"System\\CurrentControlSet\\Services\\WbioSrvc\\Databases", 
                0, 
                KEY_WRITE,
                &databaseListKey 
                ));
    if (FAILED(hr))
    {
        return hr;
    }

    HKEY newDatabaseKey = NULL;
    DWORD keyDisposition = 0;
    hr = HRESULT_FROM_WIN32(
            RegCreateKeyExW(
                databaseListKey, 
                databaseKeyName, 
                0, 
                NULL, 
                REG_OPTION_NON_VOLATILE, 
                KEY_WRITE, 
                NULL, 
                &newDatabaseKey,
                &keyDisposition
                ));
    if (SUCCEEDED(hr))
    {
        if (keyDisposition == REG_OPENED_EXISTING_KEY)
        {
            hr = WINBIO_E_DATABASE_ALREADY_EXISTS;
        }

        if (SUCCEEDED(hr))
        {
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"Attributes", 
                        0, 
                        REG_DWORD, 
                        (LPBYTE)&StorageSchema->Attributes, 
                        sizeof(StorageSchema->Attributes)
                        ));
        }

        if (SUCCEEDED(hr))
        {
            DWORD autoCreate = 1;
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"AutoCreate", 
                        0, 
                        REG_DWORD, 
                        (LPBYTE)&autoCreate, 
                        sizeof(autoCreate)
                        ));
        }

        if (SUCCEEDED(hr))
        {
            DWORD autoName = 1;
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"AutoName", 
                        0, 
                        REG_DWORD, 
                        (LPBYTE)&autoName, 
                        sizeof(autoName)
                        ));
        }

        if (SUCCEEDED(hr))
        {
            WINBIO_BIOMETRIC_TYPE biometricType = WINBIO_TYPE_FINGERPRINT;
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"BiometricType", 
                        0, 
                        REG_DWORD, 
                        (LPBYTE)&biometricType, 
                        sizeof(biometricType)
                        ));
        }

        if (SUCCEEDED(hr))
        {
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"ConnectionString", 
                        0, 
                        REG_SZ, 
                        (LPBYTE)L"", 
                        sizeof(WCHAR)
                        ));
        }

        if (SUCCEEDED(hr))
        {
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"Filepath", 
                        0, 
                        REG_SZ, 
                        (LPBYTE)L"", 
                        sizeof(WCHAR)
                        ));
        }

        if (SUCCEEDED(hr))
        {
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"Format", 
                        0, 
                        REG_SZ, 
                        (LPBYTE)dataFormat, 
                        (DWORD)((wcsnlen_s(
                                    dataFormat, 
                                    ARRAYSIZE(dataFormat)) + 1) * sizeof(WCHAR))
                                    ));
        }

        if (SUCCEEDED(hr))
        {
            DWORD initialSize = 32;
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newDatabaseKey, 
                        L"InitialSize", 
                        0, 
                        REG_DWORD, 
                        (LPBYTE)&initialSize, 
                        sizeof(initialSize)
                        ));
        }

        RegCloseKey( newDatabaseKey );
        newDatabaseKey = NULL;
    }

    RegCloseKey( databaseListKey );
    databaseListKey = NULL;
    return hr;
}

//-----------------------------------------------------------------------------

HRESULT
UnregisterDatabase(
    __in WINBIO_UUID *DatabaseId
    )
{
    HRESULT hr = S_OK;

    if (!ARGUMENT_PRESENT(DatabaseId))
    {
        return E_POINTER;
    }

    WCHAR databaseKeyName[MAX_PATH] = {};
    if (!ConvertUuidToString( 
            DatabaseId, 
            databaseKeyName, 
            ARRAYSIZE(databaseKeyName), 
            true
            ))
    {
        return E_INVALIDARG;
    }

    WINBIO_STORAGE_SCHEMA *storageArray = NULL;
    SIZE_T storageCount = 0;
    hr = WinBioEnumDatabases( WINBIO_TYPE_FINGERPRINT, &storageArray, &storageCount );
    if (SUCCEEDED(hr))
    {
        WINBIO_STORAGE_SCHEMA *storageSchema = NULL;
        for (SIZE_T i = 0; i < storageCount; ++i)
        {
            if (storageArray[i].DatabaseId == *DatabaseId)
            {
                storageSchema = &storageArray[i];
                break;
            }
        }

        if (storageSchema == NULL)
        {
            hr = WINBIO_E_DATABASE_CANT_FIND;
        }
        else
        {
            HKEY databaseListKey = NULL;
            hr = HRESULT_FROM_WIN32(
                    RegOpenKeyExW( 
                        HKEY_LOCAL_MACHINE, 
                        L"System\\CurrentControlSet\\Services\\WbioSrvc\\Databases", 
                        0, 
                        KEY_WRITE,
                        &databaseListKey 
                        ));
            if (SUCCEEDED(hr))
            {
                hr = HRESULT_FROM_WIN32(
                        RegDeleteKeyExW(
                            databaseListKey,
                            databaseKeyName,
                            KEY_WOW64_64KEY,
                            0
                            ));
                if (SUCCEEDED(hr) &&
                    wcsnlen_s(storageSchema->FilePath, ARRAYSIZE(storageSchema->FilePath)) > 0)
                {
                    // delete the database file
                    if (!DeleteFileW( storageSchema->FilePath ))
                    {
                        hr = HRESULT_FROM_WIN32(GetLastError());
                    }
                }

                RegCloseKey( databaseListKey );
                databaseListKey = NULL;
            }
        }

        WinBioFree(storageArray);
        storageArray = NULL;
        storageCount = 0;
    }

    return hr;
}

//-----------------------------------------------------------------------------

HRESULT
RegisterPrivateConfiguration(
    __in WINBIO_UNIT_SCHEMA* UnitSchema,
    __in POOL_CONFIGURATION* Configuration
    )
{
    HRESULT hr = S_OK;

    if (!ARGUMENT_PRESENT(UnitSchema) ||
        !ARGUMENT_PRESENT(Configuration))
    {
        return E_POINTER;
    }

    DWORD sensorMode = 0;
    if (Configuration->ConfigurationFlags & WINBIO_FLAG_BASIC)
    {
        sensorMode = WINBIO_SENSOR_BASIC_MODE;
    }
    else if (Configuration->ConfigurationFlags & WINBIO_FLAG_ADVANCED)
    {
        sensorMode = WINBIO_SENSOR_ADVANCED_MODE;
    }
    else
    {
        return WINBIO_E_CONFIGURATION_FAILURE;
    }

    WCHAR databaseId[MAX_PATH];
    if (!ConvertUuidToString( 
            &Configuration->DatabaseId, 
            databaseId, 
            ARRAYSIZE(databaseId), 
            false
            ))
    {
        return E_INVALIDARG;
    }

    std::wstring regPath = L"System\\CurrentControlSet\\Enum\\";
    regPath += UnitSchema->DeviceInstanceId;
    regPath += L"\\Device Parameters\\WinBio\\Configurations";

    HKEY configListKey = NULL;
    LONG regStatus = RegOpenKeyExW( 
                        HKEY_LOCAL_MACHINE, 
                        regPath.c_str(), 
                        0, 
                        KEY_READ | KEY_WRITE,
                        &configListKey 
                        );
    if (regStatus != ERROR_SUCCESS)
    {
        return HRESULT_FROM_WIN32(regStatus);
    }

    LONG highestConfigKeyValue = -1;
    DWORD subkeyIndex = 0;
    for (;;)
    {
        hr = S_OK;

        WCHAR subkeyName[MAX_PATH] = {};
        DWORD subkeyNameLength = ARRAYSIZE(subkeyName);
        regStatus = RegEnumKeyExW( 
                        configListKey, 
                        subkeyIndex, 
                        (LPWSTR)&subkeyName, 
                        &subkeyNameLength, 
                        NULL, 
                        NULL, 
                        NULL, 
                        NULL 
                        );
        if (regStatus != ERROR_SUCCESS)
        {
            if (regStatus == ERROR_NO_MORE_ITEMS)
            {
                hr = S_OK;
            }
            else
            {
                hr = HRESULT_FROM_WIN32(regStatus);
            }
            break;
        }

        if (IsKeyNameNumeric( subkeyName, subkeyNameLength ))
        {
            // See if the config we're trying to register 
            // is already registered for this sensor
            bool collision = false;
            hr = CompareConfiguration(
                    configListKey,
                    subkeyName,
                    Configuration,
                    &collision
                    );
            if (SUCCEEDED(hr) && collision)
            {
                hr = WINBIO_E_CONFIGURATION_FAILURE;
            }
            if (FAILED(hr))
            {
                break;
            }

            // Convert key name to number and see if 
            // it's bigger than the highest one we've
            // seen so far; if so, keep it
            LONG thisKey = _wtoi(subkeyName);
            highestConfigKeyValue = max( thisKey, highestConfigKeyValue );
        }
        ++subkeyIndex;
    }

    if (SUCCEEDED(hr))
    {
        WCHAR newConfigKeyName[20] = {};
        _itow_s( (highestConfigKeyValue + 1), newConfigKeyName, ARRAYSIZE(newConfigKeyName), 10 );

        HKEY newConfigKey = NULL;
        DWORD keyDisposition = 0;
        hr = HRESULT_FROM_WIN32(
                RegCreateKeyExW(
                    configListKey, 
                    newConfigKeyName, 
                    0, 
                    NULL, 
                    REG_OPTION_NON_VOLATILE, 
                    KEY_WRITE, 
                    NULL, 
                    &newConfigKey,
                    &keyDisposition
                    ));
        if (SUCCEEDED(hr))
        {
            /*
                Create values for this configuration
                    SensorMode              - REG_DWORD
                    SystemSensor            - REG_DWORD (always zero for private configs)
                    DatabaseId              - REG_SZ
                    SensorAdapterBinary     - REG_SZ
                    EngineAdapterBinary     - REG_SZ
                    StorageAdapterBinary    - REG_SZ
            */
            hr = HRESULT_FROM_WIN32(
                    RegSetValueExW( 
                        newConfigKey, 
                        L"SensorMode", 
                        0, 
                        REG_DWORD, 
                        (LPBYTE)&sensorMode, 
                        sizeof(sensorMode)
                        ));

            if (SUCCEEDED(hr))
            {
                DWORD sytemSensor = 0;
                hr = HRESULT_FROM_WIN32(
                        RegSetValueExW( 
                            newConfigKey, 
                            L"SystemSensor", 
                            0, 
                            REG_DWORD, 
                            (LPBYTE)&sytemSensor, 
                            sizeof(sytemSensor)
                            ));
            }

            if (SUCCEEDED(hr))
            {
                hr = HRESULT_FROM_WIN32(
                        RegSetValueExW( 
                            newConfigKey, 
                            L"DatabaseId", 
                            0, 
                            REG_SZ, 
                            (LPBYTE)databaseId, 
                            (DWORD)((wcsnlen_s(
                                        databaseId, 
                                        ARRAYSIZE(databaseId)) + 1) * sizeof(WCHAR))
                                        ));
            }

            if (SUCCEEDED(hr))
            {
                hr = HRESULT_FROM_WIN32(
                        RegSetValueExW( 
                            newConfigKey, 
                            L"SensorAdapterBinary", 
                            0, 
                            REG_SZ, 
                            (LPBYTE)Configuration->SensorAdapter, 
                            (DWORD)((wcsnlen_s(
                                        Configuration->SensorAdapter, 
                                        ARRAYSIZE(Configuration->SensorAdapter)) + 1) * sizeof(WCHAR))
                                        ));
            }

            if (SUCCEEDED(hr))
            {
                hr = HRESULT_FROM_WIN32(
                        RegSetValueExW( 
                            newConfigKey, 
                            L"EngineAdapterBinary", 
                            0, 
                            REG_SZ, 
                            (LPBYTE)Configuration->EngineAdapter, 
                            (DWORD)((wcsnlen_s(
                                        Configuration->EngineAdapter, 
                                        ARRAYSIZE(Configuration->EngineAdapter)) + 1) * sizeof(WCHAR))
                                        ));
            }

            if (SUCCEEDED(hr))
            {
                hr = HRESULT_FROM_WIN32(
                        RegSetValueExW( 
                            newConfigKey, 
                            L"StorageAdapterBinary", 
                            0, 
                            REG_SZ, 
                            (LPBYTE)Configuration->StorageAdapter, 
                            (DWORD)((wcsnlen_s(
                                        Configuration->StorageAdapter, 
                                        ARRAYSIZE(Configuration->StorageAdapter)) + 1) * sizeof(WCHAR))
                                        ));
            }

            RegCloseKey( newConfigKey );
            newConfigKey = NULL;
        }
    }

    RegCloseKey( configListKey );
    configListKey = NULL;

    return hr;
}

//-----------------------------------------------------------------------------

HRESULT
UnregisterPrivateConfiguration(
    __in WINBIO_UNIT_SCHEMA* UnitSchema,
    __in WINBIO_UUID *DatabaseId,
    __out bool *ConfigurationRemoved
    )
{
    HRESULT hr = S_OK;

    if (!ARGUMENT_PRESENT(UnitSchema) ||
        !ARGUMENT_PRESENT(DatabaseId))
    {
        return E_POINTER;
    }

    WCHAR targetDatabaseId[40];
    if (!ConvertUuidToString( 
            DatabaseId, 
            targetDatabaseId, 
            ARRAYSIZE(targetDatabaseId), 
            false
            ))
    {
        return E_INVALIDARG;
    }

    std::wstring regPath = L"System\\CurrentControlSet\\Enum\\";
    regPath += UnitSchema->DeviceInstanceId;
    regPath += L"\\Device Parameters\\WinBio\\Configurations";

    HKEY configListKey = NULL;
    hr = HRESULT_FROM_WIN32(
            RegOpenKeyExW( 
                HKEY_LOCAL_MACHINE, 
                regPath.c_str(), 
                0, 
                KEY_READ | KEY_WRITE,
                &configListKey 
                ));
    if (FAILED(hr))
    {
        return hr;
    }

    bool configurationRemoved = false;
    DWORD subkeyIndex = 0;
    for (;;)
    {
        hr = S_OK;

        WCHAR configKeyName[MAX_PATH] = {};
        DWORD configKeyNameLength = ARRAYSIZE(configKeyName);
        LONG regStatus = RegEnumKeyExW( 
                            configListKey, 
                            subkeyIndex, 
                            (LPWSTR)&configKeyName, 
                            &configKeyNameLength, 
                            NULL, 
                            NULL, 
                            NULL, 
                            NULL 
                            );
        if (regStatus != ERROR_SUCCESS)
        {
            if (regStatus == ERROR_NO_MORE_ITEMS)
            {
                hr = S_OK;
            }
            else
            {
                hr = HRESULT_FROM_WIN32(regStatus);
            }
            break;
        }

        if (IsKeyNameNumeric( configKeyName, configKeyNameLength ))
        {
            WCHAR configDatabaseId[40] = {};
            DWORD dataSize = sizeof(configDatabaseId);
            hr = HRESULT_FROM_WIN32(
                    RegGetValueW( 
                        configListKey, 
                        configKeyName, 
                        L"DatabaseId", 
                        RRF_RT_REG_SZ, 
                        NULL, 
                        &configDatabaseId, 
                        &dataSize 
                        ));
            if (SUCCEEDED(hr) &&
                _wcsnicmp(configDatabaseId, targetDatabaseId, ARRAYSIZE(configDatabaseId)) == 0)
            {
                hr = HRESULT_FROM_WIN32(
                        RegDeleteKeyExW(
                            configListKey,
                            configKeyName,
                            KEY_WOW64_64KEY,
                            0
                            ));
                if (SUCCEEDED(hr))
                {
                    configurationRemoved = true;
                }
            }
        }
        if (SUCCEEDED(hr))
        {
            ++subkeyIndex;
        }
        else
        {
            break;
        }
    }

    RegCloseKey( configListKey );
    configListKey = NULL;
    *ConfigurationRemoved = configurationRemoved;
    return hr;
}

//-----------------------------------------------------------------------------

static HRESULT
CompareConfiguration(
    __in HKEY SourceConfigList,
    __in LPWSTR SourceConfigKey,
    __in POOL_CONFIGURATION* TargetConfig,
    __out bool *IsEqual
    )
{

    if (SourceConfigList == NULL)
    {
        return E_INVALIDARG;
    }

    if (!ARGUMENT_PRESENT(SourceConfigKey) ||
        !ARGUMENT_PRESENT(TargetConfig) ||
        !ARGUMENT_PRESENT(IsEqual))
    {
        return E_POINTER;
    }

    WCHAR targetDatabaseId[40];
    if (!ConvertUuidToString( 
            &TargetConfig->DatabaseId, 
            targetDatabaseId, 
            ARRAYSIZE(targetDatabaseId), 
            false
            ))
    {
        return E_INVALIDARG;
    }

    HKEY srcConfig = NULL;
    HRESULT hr = HRESULT_FROM_WIN32(
                    RegOpenKeyExW(
                        SourceConfigList,
                        SourceConfigKey,
                        0,
                        KEY_READ,
                        &srcConfig
                        ));
    if (SUCCEEDED(hr))
    {
        bool isEqual = true;

        WCHAR configDatabaseId[40] = {};
        DWORD dataSize = sizeof(configDatabaseId);
        hr = HRESULT_FROM_WIN32(
                RegGetValueW( 
                    srcConfig, 
                    NULL, 
                    L"DatabaseId", 
                    RRF_RT_REG_SZ, 
                    NULL, 
                    &configDatabaseId, 
                    &dataSize 
                    ));
        if (SUCCEEDED(hr) &&
            _wcsnicmp(configDatabaseId, targetDatabaseId, ARRAYSIZE(configDatabaseId)) != 0)
        {
            isEqual = false;
        }

        RegCloseKey( srcConfig );
        srcConfig = NULL;

        if (SUCCEEDED(hr))
        {
            *IsEqual = isEqual;
        }
    }
    return hr;
}

//-----------------------------------------------------------------------------

static bool
ConvertStringToUuid(
    __in LPWSTR UuidString,
    __out WINBIO_UUID *Uuid
    )
{
    int data1 = 0;
    int data2 = 0;
    int data3 = 0;
    int data40 = 0;
    int data41 = 0;
    int data42 = 0;
    int data43 = 0;
    int data44 = 0;
    int data45 = 0;
    int data46 = 0;
    int data47 = 0;
    int conversionCount = swscanf_s(
        UuidString, 
        L"%8x-%4x-%4x-%2x%2x-%2x%2x%2x%2x%2x%2x",
        &data1,
        &data2,
        &data3,
        &data40,
        &data41,
        &data42,
        &data43,
        &data44,
        &data45,
        &data46,
        &data47
        );

    if (conversionCount != 11)
    {
        return false;
    }

    Uuid->Data1    = data1;
    Uuid->Data2    = (WORD)data2;
    Uuid->Data3    = (WORD)data3;
    Uuid->Data4[0] = (BYTE)data40;
    Uuid->Data4[1] = (BYTE)data41;
    Uuid->Data4[2] = (BYTE)data42;
    Uuid->Data4[3] = (BYTE)data43;
    Uuid->Data4[4] = (BYTE)data44;
    Uuid->Data4[5] = (BYTE)data45;
    Uuid->Data4[6] = (BYTE)data46;
    Uuid->Data4[7] = (BYTE)data47;

    return true;
}

//-----------------------------------------------------------------------------

static bool
ConvertUuidToString(
    __in WINBIO_UUID *Uuid,
    __out LPWSTR UuidStringBuffer,
    __in SIZE_T UuidStringBufferLength,
    __in bool IncludeBraces
    )
{
    const PWSTR fmt_no_braces = L"%8X-%4X-%4X-%2X%2X-%2X%2X%2X%2X%2X%2X";
    const PWSTR fmt_braces    = L"{%8X-%4X-%4X-%2X%2X-%2X%2X%2X%2X%2X%2X}";

    int charsWritten = swprintf_s( 
                            UuidStringBuffer, 
                            UuidStringBufferLength, 
                            IncludeBraces?fmt_braces:fmt_no_braces,
                            Uuid->Data1,
                            Uuid->Data2,
                            Uuid->Data3,
                            Uuid->Data4[0],
                            Uuid->Data4[1],
                            Uuid->Data4[2],
                            Uuid->Data4[3],
                            Uuid->Data4[4],
                            Uuid->Data4[5],
                            Uuid->Data4[6],
                            Uuid->Data4[7]
                            );
    if (charsWritten < 0)
    {
        return false;
    }
    return true;
}

//-----------------------------------------------------------------------------


}; // namespace BioHelper

Display.cpp

以下文件包含输出格式设置例程。

/******************************************************************************
THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE.

Copyright (C) Microsoft.  All rights reserved.

This source code is only intended as a supplement to Microsoft Development
Tools and/or WinHelp documentation.  See these sources for detailed information
regarding the Microsoft samples programs.
******************************************************************************/

/*
    Output formatting routines...
*/
#include "stdafx.h"


typedef struct _SUBFACTOR_TEXT {
    WINBIO_BIOMETRIC_SUBTYPE SubFactor;
    LPCTSTR Text;
} SUBFACTOR_TEXT, *PSUBFACTOR_TEXT;

static const SUBFACTOR_TEXT g_SubFactorText[] = {
    {WINBIO_SUBTYPE_NO_INFORMATION,             _T("(No information)")},
    {WINBIO_ANSI_381_POS_RH_THUMB,              _T("RH thumb")},
    {WINBIO_ANSI_381_POS_RH_INDEX_FINGER,       _T("RH index finger")},
    {WINBIO_ANSI_381_POS_RH_MIDDLE_FINGER,      _T("RH middle finger")},
    {WINBIO_ANSI_381_POS_RH_RING_FINGER,        _T("RH ring finger")},
    {WINBIO_ANSI_381_POS_RH_LITTLE_FINGER,      _T("RH little finger")},
    {WINBIO_ANSI_381_POS_LH_THUMB,              _T("LH thumb")},
    {WINBIO_ANSI_381_POS_LH_INDEX_FINGER,       _T("LH index finger")},
    {WINBIO_ANSI_381_POS_LH_MIDDLE_FINGER,      _T("LH middle finger")},
    {WINBIO_ANSI_381_POS_LH_RING_FINGER,        _T("LH ring finger")},
    {WINBIO_ANSI_381_POS_LH_LITTLE_FINGER,      _T("LH little finger")},
    {WINBIO_SUBTYPE_ANY,                        _T("Any finger")},
};
static const SIZE_T k_SubFactorTextTableSize = sizeof(g_SubFactorText)/sizeof(SUBFACTOR_TEXT);


typedef struct _REJECT_DETAIL_TEXT {
    WINBIO_REJECT_DETAIL RejectDetail;
    LPCTSTR Text;
} REJECT_DETAIL_TEXT, *PREJECT_DETAIL_TEXT;

static const REJECT_DETAIL_TEXT g_RejectDetailText[] = {
    {WINBIO_FP_TOO_HIGH,        _T("Scan your fingerprint a little lower.")},
    {WINBIO_FP_TOO_LOW,         _T("Scan your fingerprint a little higher.")},
    {WINBIO_FP_TOO_LEFT,        _T("Scan your fingerprint more to the right.")},
    {WINBIO_FP_TOO_RIGHT,       _T("Scan your fingerprint more to the left.")},
    {WINBIO_FP_TOO_FAST,        _T("Scan your fingerprint more slowly.")},
    {WINBIO_FP_TOO_SLOW,        _T("Scan your fingerprint more quickly.")},
    {WINBIO_FP_POOR_QUALITY,    _T("The quality of the fingerprint scan was not sufficient to make a match.  Check to make sure the sensor is clean.")},
    {WINBIO_FP_TOO_SKEWED,      _T("Hold your finger flat and straight when scanning your fingerprint.")},
    {WINBIO_FP_TOO_SHORT,       _T("Use a longer stroke when scanning your fingerprint.")},
    {WINBIO_FP_MERGE_FAILURE,   _T("Unable to merge samples into a single enrollment. Try to repeat the enrollment procedure from the beginning.")},
};
static const SIZE_T k_RejectDetailTextTableSize = sizeof(g_RejectDetailText)/sizeof(REJECT_DETAIL_TEXT);


namespace BioHelper
{

LPTSTR
ConvertErrorCodeToString(
    __in HRESULT ErrorCode
    )
{
    TCHAR *messageBuffer = NULL;
    DWORD messageLength = 0;

    std::vector<TCHAR> systemPath;
    UINT systemPathSize = 0;
    systemPathSize = GetSystemWindowsDirectory( NULL, 0);
    systemPath.resize(systemPathSize);
    systemPathSize = GetSystemWindowsDirectory( (LPTSTR)&systemPath[0], systemPathSize);

    TSTRING libraryPath = &systemPath[0];
    libraryPath += _T("\\system32\\winbio.dll");

    HMODULE winbioLibrary = NULL;
    winbioLibrary = LoadLibraryEx(
                        libraryPath.c_str(),
                        NULL,
                        LOAD_LIBRARY_AS_DATAFILE |
                            LOAD_LIBRARY_AS_IMAGE_RESOURCE
                        );
    if (winbioLibrary != NULL)
    {
        messageLength = FormatMessage(
                            FORMAT_MESSAGE_ALLOCATE_BUFFER |
                                FORMAT_MESSAGE_FROM_HMODULE |
                                FORMAT_MESSAGE_FROM_SYSTEM,
                            winbioLibrary,
                            ErrorCode,
                            0,                      // LANGID
                            (LPTSTR)&messageBuffer,
                            0,                      // arg count
                            NULL                    // arg array
                            );
        if (messageLength > 0)
        {
            // success
            messageBuffer[messageLength] = _T('\0');
        }
        FreeLibrary(winbioLibrary);
        winbioLibrary = NULL;
    }

    if (messageBuffer == NULL)
    {
        messageLength = 10 ;    // "0x" + "%08x"
        messageBuffer = (TCHAR*)LocalAlloc( LPTR, (messageLength + 1) * sizeof(TCHAR));
        if (messageBuffer != NULL)
        {
            _stprintf_s( messageBuffer, messageLength, _T("0x%08x"), ErrorCode);
        }
    }

    // Caller must release buffer with LocalFree()
    return messageBuffer;
}

//-----------------------------------------------------------------------------

LPCTSTR
ConvertSubFactorToString(
    __in WINBIO_BIOMETRIC_SUBTYPE SubFactor
    )
{
    SIZE_T index = 0;
    for (index = 0; index < k_SubFactorTextTableSize; ++index)
    {
        if (g_SubFactorText[index].SubFactor == SubFactor)
        {
            return g_SubFactorText[index].Text;
        }
    }
    return _T("<Unknown>");
}

//-----------------------------------------------------------------------------

LPCTSTR
ConvertRejectDetailToString(
    __in WINBIO_REJECT_DETAIL RejectDetail
    )
{
    SIZE_T index = 0;
    for (index = 0; index < k_RejectDetailTextTableSize; ++index)
    {
        if (g_RejectDetailText[index].RejectDetail == RejectDetail)
        {
            return g_RejectDetailText[index].Text;
        }
    }
    return _T("Reason for failure couldn't be diagnosed.");
}

//-----------------------------------------------------------------------------


}; // namespace BioHelper