TSPI_lineGetExtensionID函式 (tspi.h)
TSPI_lineGetExtensionID函式會傳回服務提供者針對指定的線路裝置所支援的擴充標識碼。
語法
LONG TSPIAPI TSPI_lineGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPLINEEXTENSIONID lpExtensionID
);
參數
dwDeviceID
要查詢的線路裝置。
dwTSPIVersion
已 使用此裝置TSPI_lineNegotiateTSPIVersion交涉的介面版本號碼。 此函式會根據這個版本層級的介面規格運作。
lpExtensionID
LINEEXTENSIONID 類型的結構的指標。 如果服務提供者支援提供者特定的延伸模組，它會以這些延伸模組的擴充標識符填入此結構。 如果服務提供者不支援延伸模組，則會以所有零填入此結構。 (因此，有效的擴充標識碼不能包含所有零。)
傳回值
如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。
備註
TAPI 通常會呼叫此函式，以回應呼叫 lineNegotiateAPIVersion 函式的應用程式。 服務提供者傳回的結果應該適用於後續呼叫 TSPI_lineNegotiateExtVersion。 所有零的擴充標識碼不是合法的延伸模組標識符，因為所有零值是用來指出服務提供者不支援延伸模組。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |