2.2.89 FAX_TAPI_LOCATION_INFO

The FAX_TAPI_LOCATION_INFO structure describes the configuration of all TAPI locations for a fax server. This structure is used as an input argument for the FaxObs_SetTapiLocations (section 3.1.4.2.29) method and is returned by the FaxObs_GetTapiLocations (section 3.1.4.2.28) method. The structure contains an array of FAX_TAPI_LOCATIONS (section 2.2.88) structures. Each of these structures describes one TAPI location of the fax server, and also contains information about which of these TAPI locations is the current location. For more information about TAPI, see [MSDN-TAPI2.2].

This data structure is custom marshaled as follows and uses the custom marshaling rules defined in section 2.2.1.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Fixed_Portion

...

...

Variable_Data (variable)

...

Fixed_Portion (12 bytes):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

CurrentLocationID

NumLocations

TapiLocationsOffset

CurrentLocationID (4 bytes): A DWORD ([MS-DTYP] section 2.2.9) that holds the value of the PermanentLocationID member of the FAX_TAPI_LOCATIONS from the list referenced by TapiLocationsOffset. This FAX_TAPI_LOCATIONS represents the current TAPI location for the server.

NumLocations (4 bytes): A DWORD that holds the number of FAX_TAPI_LOCATIONS in the list referenced by TapiLocationsOffset.

TapiLocationsOffset (4 bytes): Offset to the TapiLocations field in the Variable_Data block of the structure.

Variable_Data (variable):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

TapiLocations (variable)

...

TapiLocations (variable): An array of FAX_TAPI_LOCATIONS, custom marshaled as described in section 2.2.1.2.