共用方式為


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