2.2.88 FAX_TAPI_LOCATIONS

The FAX_TAPI_LOCATIONS structure describes one TAPI location. This structure is used in the FAX_TAPI_LOCATION_INFO (section 2.2.89) structure. 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 (24 bytes)

...

...

...

Variable_Data (variable)

...

Fixed_Portion (24 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

PermanentLocationID

LocationNameOffset

CountryCode

AreaCode

NumTollPrefixes

TollPrefixesOffset

PermanentLocationID (4 bytes): A DWORD ([MS-DTYP] section 2.2.9) that holds a numeric identifier of the TAPI location described by this structure. This value is used to uniquely identify the current TAPI location in the array of FAX_TAPI_LOCATIONS specified by the TapiLocations Variable_Data member of a FAX_TAPI_LOCATION_INFO.

LocationNameOffset (4 bytes): Offset to the LocationName field in the Variable_Data block of the structure.

CountryCode (4 bytes): A DWORD containing the country code for this TAPI location.

AreaCode (4 bytes): A DWORD containing the area code for this TAPI location.

NumTollPrefixes (4 bytes): A DWORD containing the number of toll prefixes contained in the TollPrefixes field in the Variable_Data block of the structure.

TollPrefixesOffset (4 bytes): Offset to the TollPrefixes 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

LocationName (variable)

...

TollPrefixes (variable)

...

LocationName (variable): A null-terminated character string containing the friendly name of the TAPI location described by this structure.

TollPrefixes (variable): An optional null-terminated character string containing one or multiple toll prefixes separated by a "," character. A toll prefix is a number and is represented in this string with decimal-digit characters.