Platform SDK: TAPI

TSPI_providerUIIdentify

The TSPI_providerUIIdentify function extracts from the service provider the fully qualified path to load the service provider's UI DLL component.

Implementation is mandatory if the service provider implements any UI DLL functions.

LONG TSPIAPI TSPI_providerUIIdentify(
  LPWSTR lpszUIDLLName  
); 

Parameters

lpszUIDLLName
Pointer to a block of memory at least MAX_PATH in length, into which the service provider must copy a null-terminated string specifying the fully-qualified path for the DLL containing the service provider functions which must execute in the process of the calling application.

Return Values

Returns zero if successful. Shouldn't ever fail, but if it does returns one of these negative error values:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tspi.h.