我们知道，要在Intel的AppUp中发布程序，必须通过Adp小组的验证。而验证的最重要一项是，你的程序必须调用Adp sdk中的函数，比如初始化adp、adp授权、退出adp。基于adp内嵌的服务，你的程序便能通过AppUp平台实现授权和收费。

        IADP目前还处于非正式发布阶段，目前的版本是0.91（前几天刚刚发布了0.92）。按照通常的做法，WPF/C#程序要想使用C/C++的库函数进行开发，那就必须封装其dll（除非它是ocx控件），将其中的函数导出，这样C#程序就可以调用了。但是，IADP sdk只提供静态链接库，所以无法用C#直接封装，而必须新建一个C/C++的dll项目，包装一下此sdk静态库，然后再用C#dll将此C++ dll 中的函数导出。

        基本实现如下：

        1、打开Visual Studio 2008， 新建一个C++ Win32 的 dll 项目，命名为Adplib2dll；

        2、将adpcore.lib和adpcore.h从Intel IADP SDK安装目录中拷贝到本项目文件夹中，并加入到项目中；

        3、在Adplib2dll.h中，系数定义adpcore.h中包含的函数：

#pragma once

/* =======================================================================================
// Author :   YuanHui HE
// Data:      2010.05.22
// Copyright: YuanHui HE, all rights reserved.
//
//========================================================================================
//
// 命名约定及后续修改说明：
// 此动态库包装Intel Application Development Program SDK 静态lib库，
// 将其导出为动态dll库，以便C#程序包装使用
// 1、此dll基本原样包装并导出所有lib函数及其变量
// 2、所有命名以ADP开头：ADPXxxxxx，以便与原函数区别（原函数命名格式为ADP_Xxxxxxx）
// 3、Guid及一些函数参数做了相应修改（如Crash data），以便C#二次包装
// 4、装载此dll时将lib中的一些常数做了格式化后传递到本dll中
// 4、装载此dll时做了授权验证，因此，没有授权的用户将无法使用此dll
//
//
//
// ========================================================================================
*/

// 下列 ifdef 块是创建使从 DLL 导出更简单的
// 宏的标准方法。此 DLL 中的所有文件都是用命令行上定义的 ADPLIB2DLL_EXPORTS
// 符号编译的。在使用此 DLL 的
// 任何其他项目上不应定义此符号。这样，源文件中包含此文件的任何其他项目都会将
// ADPLIB2DLL_API 函数视为是从 DLL 导入的，而此 DLL 则将用此宏定义的
// 符号视为是被导出的。
#ifdef ADPLIB2DLL_EXPORTS
#define ADPLIB2DLL_API __declspec(dllexport)
#else
#define ADPLIB2DLL_API __declspec(dllimport)
#endif
#ifdef __cplusplus
extern "C" {
#endif

//===================================================
 ADPLIB2DLL_API int ADPInitialize();
 ADPLIB2DLL_API int ADPClose();

 // char* ApplicationGUID：四段四个字节组成的Guid
 ADPLIB2DLL_API int ADPIsAuthorized(wchar_t* ApplicationGUID);
 ADPLIB2DLL_API int ADPIsAuthorizedDebug();

 // char* ComponentGUID：四段四个字节组成的Guid
 ADPLIB2DLL_API int ADPIsAppAuthorized(wchar_t* ComponentGUID);
 ADPLIB2DLL_API int ADPIsAppAuthorizedDebug();

 typedef struct {
  // custom crash report field:
  wchar_t *FieldName;
  wchar_t *FieldValue;
  unsigned long FieldNumber;
  wchar_t *ErrorData;
  unsigned long ErrorDataSize;
  
  wchar_t *Module;
  unsigned long LineNumber;
  wchar_t *Message;
  wchar_t *Category;
 } ADPCrashReportData;

 ADPLIB2DLL_API int ADPReportCrash(ADPCrashReportData *data);

 ADPLIB2DLL_API int ADPApplicationBeginEvent();
 ADPLIB2DLL_API int ADPApplicationEndEvent();
 
 ADPLIB2DLL_API extern const wchar_t* ADPAPIVersion;
 ADPLIB2DLL_API extern const unsigned long ADPAPILevel;
 ADPLIB2DLL_API extern wchar_t* ADPDebugApplicationId;
 ADPLIB2DLL_API extern wchar_t* ADPDebugComponentId;
 ADPLIB2DLL_API extern wchar_t* ADPExpiredApplicationId;
 ADPLIB2DLL_API extern wchar_t* ADPExpiredComponentId;

 
 ADPLIB2DLL_API const wchar_t* ADPGetAPIVersion();
 ADPLIB2DLL_API unsigned long ADPGetAPILevel();
 ADPLIB2DLL_API wchar_t* ADPGetDebugApplicationId();
 ADPLIB2DLL_API wchar_t* ADPGetDebugComponentId();
 ADPLIB2DLL_API wchar_t* ADPGetExpiredApplicationId();
 ADPLIB2DLL_API wchar_t* ADPGetExpiredComponentId(); 

//===================================================

#ifdef __cplusplus
} /* closing brace for extern "C" */
#endif

        上面的函数和变量的命名，为了与原api区分，把ADP后的下划线去了；

         4、同样，在Adplib2dll.cpp实现这些函数，其实就是简单调用ADP 的 sdk：

// Adplib2dll.cpp : 定义 DLL 应用程序的导出函数。
//

#include "stdafx.h"
#include "Adplib2dll.h"
#include "adpcore.h"
#include "internal.h"
//===================================================

const wchar_t* ADPAPIVersion = ADP_API_VERSION;
const unsigned long ADPAPILevel = ADP_API_LEVEL;
wchar_t* ADPDebugApplicationId;// = ADP_DEBUG_APPLICATIONID;
wchar_t* ADPDebugComponentId;// = ADP_DEBUG_COMPONENTID;
wchar_t* ADPExpiredApplicationId;// = ADP_EXPIRED_APPLICATIONID;
wchar_t* ADPExpiredComponentId;// = ADP_EXPIRED_COMPONENTID;
int ADPInitialize()
{
 ADP_RET_CODE ret = ADP_Initialize();
 checkRetCode(ret, L"ADP_Initialize()");
 return  ret;
}
int ADPClose()
{
 return  ADP_Close();
}

// char* ApplicationGUID：四段四个字节组成的Guid，
// 格式：'1234,1234,1234,1234'
int ADPIsAuthorized(wchar_t* applicationId)
{
  ADP_RET_CODE ret = ADP_IsAuthorized(*((ADP_APPLICATIONID*)applicationId));
 checkRetCode(ret, L"ADP_IsAuthorized()");

 return  ret;
}

int ADPIsAuthorizedDebug()
{
 ADP_RET_CODE ret = ADP_IsAuthorized(ADP_DEBUG_APPLICATIONID);
 checkRetCode(ret, L"ADP_IsAuthorized()");

 return  ret;
}

// char* ComponentGUID：四段四个字节组成的Guid
int ADPIsAppAuthorized(wchar_t* componentId)
{

 ADP_RET_CODE ret = ADP_IsAppAuthorized(*((ADP_COMPONENTID*)componentId));
 checkRetCode(ret, L"ADP_IsAppAuthorized()");

 return  ret;
}

int ADPIsAppAuthorizedDebug()
{
 ADP_RET_CODE ret = ADP_IsAppAuthorized(ADP_DEBUG_COMPONENTID);
 checkRetCode(ret, L"ADP_IsAppAuthorized()");

 return  ret;
}

int ADPReportCrash(ADPCrashReportData *data)
{
 ADP_CrashReportField field;
 field.name = data->FieldName;
 field.value = data->FieldValue;

 return  ADP_ReportCrash(
       data->Module,
       data->LineNumber,
       data->Message,
       data->Category,
       data->ErrorData,
       data->ErrorDataSize,
       &field,
       data->FieldNumber);
}

int ADPApplicationBeginEvent()
{
 ADP_RET_CODE ret = ADP_ApplicationBeginEvent();
 checkRetCode(ret, L"ADP_ApplicationBeginEvent()");

 return  ret;
}
int ADPApplicationEndEvent()
{
 ADP_RET_CODE ret = ADP_ApplicationEndEvent();
 checkRetCode(ret, L"ADP_ApplicationEndEvent()");

 return  ret;
}

 
const wchar_t* ADPGetAPIVersion()
{
 return ADPAPIVersion;
}
unsigned long ADPGetAPILevel()
{
 return ADPAPILevel;
}
wchar_t* ADPGetDebugApplicationId()
{
 return ADPDebugApplicationId;
}
wchar_t* ADPGetDebugComponentId()
{
 return ADPDebugComponentId;
}
wchar_t* ADPGetExpiredApplicationId()
{
 return ADPExpiredApplicationId;
}
wchar_t* ADPGetExpiredComponentId()
{
 return ADPExpiredComponentId;
}

//===================================================

         为了使用方便，我加入了几个函数，如checkRetCode，用于检查调用的有效性和返回值；

        至此，IADP的静态库就包装成了dll。

        下面我们再从此dll中导出函数：

        5、打开VS2008，新建C#类库工程，命名为AdpExp；

        6、定义导出函数，C#源代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Runtime.InteropServices;

namespace MathFigure.AdpExporter
{
    public static class ADP
    {
        /// <summary>
        /// The ADP Initialize() function is used to set up internal data structures,
        /// and determine whether the system is compatible.
        /// This function must be the first function called else the other functions will fail with the return code ADP_NOT_INITIALIZED.
        /// If function does not return ADP_SUCCESS the application should exit.
        /// </summary>
        /// <returns></returns>
        [DllImport("Adp2dll.dll", EntryPoint = "ADPInitialize")]
        public extern static ADPRtnCode ADPInitialize();

        /// <summary>
        /// The ADP Close() function is used to release internal data structures,
        /// and shutdown connections used by the library.
        /// </summary>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPClose();

        /// <summary>
        /// The ADP IsAuthorized function determines whether the application is authorized to run.
        /// It should be called by an application after a successful call to ADP Initialize().
        /// Calling any Application Library function (besides ADP Initialize()) without a successful
        /// call to ADP IsAuthorized () (return code = ADP AUTHORIZED)
        /// will result in an error: ADP NOT_AUTHORIZED.
        /// </summary>
        /// <param name="applicationId">Authorized application Id</param>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPIsAuthorized(string applicationId);

        /// <summary>
        /// Same as ADPIsAuthorized(), but only used for debug.
        /// </summary>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPIsAuthorizedDebug();

        /// <summary>
        /// The ADP IsAppAuthorized function determines whether an application is authorized to use a component.
        /// It is the responsibility of the component developer to call the function and communicate the results to the application.
        /// </summary>
        /// <param name="ComponentId">Authorized component Id</param>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPIsAppAuthorized(string ComponentId);

        /// <summary>
        /// Same as ADPIsAppAuthorized(), but only used for debug.
        /// </summary>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPIsAppAuthorizedDebug();

        /// <summary>
        /// The ADP ReportCrash function is used by an application to report a crash.
        /// The Client Agent is responsible for delivering the crash report and the
        /// dump information to the Store Backend where the developer can view and assess the information.
        /// NOTE: Components should not call ADP ReportCrash(), only Applications.
        /// </summary>
        /// <param name="data">Crash data should translated in</param>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPReportCrash(CrashData data);

        /// <summary>
        /// The ADP ApplicationBeginEvent function creates an application start usage record.
        /// A call to this function records that the application was launched.
        /// A subsequent call to ADP ApplicationEndEvent() must be made to record the duration of use.
        /// </summary>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPApplicationBeginEvent();

        /// <summary>
        /// The ADP ApplicationEndEvent function creates an application end usage record.
        /// </summary>
        /// <returns></returns>
        [DllImport("Adp2dll.dll")]
        public extern static ADPRtnCode ADPApplicationEndEvent();

    }
}

        当然，为了使用方便，还需要定义一些变量、结构体和枚举：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace MathFigure.AdpExporter
{
    public enum ADPRtnCode
    {
        /// <summary>
        /// Other failure e.g., memory, file, communication.
        /// </summary>
        Failure = -1,

        /// <summary>
        /// Function call was successful.
        /// </summary>
        Success,

        /// <summary>
        /// Returned if the ADP Initialize() function has not been called.
        /// </summary>
        NotInitialized,

        /// <summary>
        /// The Client Agent is not installed or is not running.
        /// </summary>
        NotAvailable,

        /// <summary>
        /// The library and Client Agent are incompatible.
        /// They don’t have to be the same version, just compatible at the call level. See SDK API Versioning.
        /// </summary>
        IncompatibleVersion,

        /// <summary>
        /// ErrorDataSize exceeds 4000 characters.
        /// CustomFieldNumber should not exceed 20.
        /// Module, Message, and Category as well as name and value fields in CustomFields should not exceed 80 characters.
        /// </summary>
        ErrorDataTooBig,

        /// <summary>
        /// Application is authorized to run.
        /// </summary>
        Authorized,

        /// <summary>
        /// Application is not authorized to run.
        /// </summary>
        NotAuthorized,

        /// <summary>
        /// Application’s license has not been refreshed in the required time. It still may be valid.
        /// </summary>
        AuthorizationExpired,

        /// <summary>
        /// Returned if there has been no call to ADP_ApplicationBeginEvent().
        /// </summary>
        NoAppBeginEvent
    }
}

        如此一来，你就可以在你的项目中使用AdpExp.dll访问Intel ADP SDK了。

        上网本的市场越来越大，也许透过如此大的用户群，开发者和Intel都能赚个斗满钵满。