TSPI_phoneGetExtensionID函式 (tspi.h)

TSPI_phoneGetExtensionID函式會擷取服務提供者針對指定的電話裝置所支援的延伸模組標識符。

語法

LONG TSPIAPI TSPI_phoneGetExtensionID(
  DWORD              dwDeviceID,
  DWORD              dwTSPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

dwDeviceID

要查詢的電話裝置。

dwTSPIVersion

指定使用此裝置使用 TSPI_phoneNegotiateTSPIVersion 交涉的介面版本號碼。此函式會根據這個版本層級的介面規格運作。

lpExtensionID

PHONEEXTENSIONID 類型的結構的指標。如果服務提供者支援提供者特定的延伸模組，它會以這些延伸模組的擴充標識符填入此結構。如果服務提供者不支援延伸模組，則會以所有零填入此結構。所有零的擴充標識碼不是合法的延伸模組標識符，因為所有零值是用來指出服務提供者不支援延伸模組。

如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。可能的傳回值如下所示：

PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM PHONEERR_OPERATIONUNAVAIL。

TAPI 通常會呼叫此函式，以回應呼叫 phoneNegotiateAPIVersion 函式的應用程式。服務提供者傳回的結果應該適用於後續呼叫 TSPI_phoneNegotiateExtVersion。

需求	值
目標平台	Windows
標頭	tspi.h