MAPPING_SERVICE_INFO 结构 (elscore.h)

包含有关 ELS 服务的信息。

语法

typedef struct _MAPPING_SERVICE_INFO {
  size_t   Size;
  LPWSTR   pszCopyright;
  WORD     wMajorVersion;
  WORD     wMinorVersion;
  WORD     wBuildVersion;
  WORD     wStepVersion;
  DWORD    dwInputContentTypesCount;
  LPWSTR   *prgInputContentTypes;
  DWORD    dwOutputContentTypesCount;
  LPWSTR   *prgOutputContentTypes;
  DWORD    dwInputLanguagesCount;
  LPWSTR   *prgInputLanguages;
  DWORD    dwOutputLanguagesCount;
  LPWSTR   *prgOutputLanguages;
  DWORD    dwInputScriptsCount;
  LPWSTR   *prgInputScripts;
  DWORD    dwOutputScriptsCount;
  LPWSTR   *prgOutputScripts;
  GUID     guid;
  LPWSTR   pszCategory;
  LPWSTR   pszDescription;
  DWORD    dwPrivateDataSize;
  LPVOID   pPrivateData;
  LPVOID   pContext;
  unsigned IsOneToOneLanguageMapping : 1;
  unsigned HasSubservices : 1;
  unsigned OnlineOnly : 1;
  unsigned ServiceType : 2;
} MAPPING_SERVICE_INFO, *PMAPPING_SERVICE_INFO;

成员

Size

结构的大小,用于验证结构版本。 此值是必需的。

pszCopyright

指向有关服务的版权信息的指针。

wMajorVersion

用于跟踪服务更改的主版本号。

wMinorVersion

用于跟踪服务更改的次要版本号。

wBuildVersion

用于跟踪服务更改的内部版本。

wStepVersion

用于跟踪服务更改的步骤版本。

dwInputContentTypesCount

服务可以接收的内容类型数。

prgInputContentTypes

可选。 指向输入内容类型数组的指针,该数组遵循 MIME 内容类型的格式,用于标识服务在应用程序传递数据时解释的格式。 内容类型的示例包括“text/plain”、“text/html”和“text/css”。

注意 在 Windows 7 中,ELS 服务仅支持内容类型“text/plain”。 可以在 文本媒体类型中找到内容类型规范。
 

dwOutputContentTypesCount

服务可设置结果格式的内容类型数。

prgOutputContentTypes

可选。 指向输出内容类型数组的指针,该数组遵循 MIME 内容类型的格式,用于标识服务检索数据的格式。

dwInputLanguagesCount

服务支持的输入语言数。 如果服务可以接受任何语言的数据,则此成员设置为 0。

prgInputLanguages

指向服务接受的 IETF 命名约定的输入语言数组的指针。 如果服务可以使用任何输入语言,则此成员设置为 NULL

dwOutputLanguagesCount

服务支持的输出语言数。 如果服务可以检索任何语言的数据,或者如果服务忽略输出语言,则此成员设置为 0。

prgOutputLanguages

指向输出语言数组的指针,遵循 IETF 命名约定,服务可在其中检索结果。 如果服务可以检索任何语言的结果,或者如果服务忽略输出语言,则此成员设置为 NULL

dwInputScriptsCount

服务支持的输入脚本数。 如果服务可以接受任何脚本中的数据,则此成员设置为 0。

prgInputScripts

指向服务支持的具有 Unicode 标准脚本名称的输入脚本数组的指针。 如果服务可以处理任何脚本,或者如果服务忽略输入脚本,则此成员设置为 NULL

dwOutputScriptsCount

服务支持的输出脚本数。 如果服务可以检索任何脚本中的数据,或者如果服务忽略输出脚本,则此成员设置为 0。

prgOutputScripts

指向服务支持的输出脚本数组的指针。 如果服务可以处理任何脚本,或者服务忽略输出脚本,则此成员设置为 NULL

guid

服务的全局唯一标识符 (GUID) 。

pszCategory

指向服务的服务类别的指针,例如“语言检测”。

pszDescription

指向服务说明的指针。 此文本可以本地化。

dwPrivateDataSize

服务专用数据的大小(以字节为单位)。 如果没有专用数据,则此成员设置为 0。

pPrivateData

指向服务可以公开的私有数据的指针。 此信息是静态的,在安装服务期间会更新。

pContext

保留以供内部使用。

IsOneToOneLanguageMapping

指示服务支持的输入语言与输出语言之间的语言映射的标志。 下表中显示了可能的值。

含义
0
输入和输出语言未配对,服务可以接收任何输入语言的数据,并使用任何输出语言呈现数据。
1
服务的输入和输出语言的数组已配对。 换句话说,给定特定的输入语言,服务检索输出语言数组中定义的配对语言的结果。 语言配对的使用可能很有用,例如,在双语字典方案中。

HasSubservices

指示服务是否具有子服务(即插入服务的其他服务)的标志。 此标志在服务枚举中用于确定是否必须调用父服务才能获取子服务列表。 下表中显示了可能的值。

含义
0
该服务是独立的常规服务,没有子服务。
1
该服务充当子服务的父级。

OnlineOnly

留待将来使用。

ServiceType

保留供将来使用。

注解

此类型的结构是在 对 MappingGetServices 的应用程序调用中创建的。

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头 elscore.h

另请参阅

扩展的语言服务结构

MappingGetServices