Using BuildGlobalAddress
Building an address is an interactive process that requires you to select address elements at each step of the address building process. This means that building an address requires a sequence of calls to BuildGlobalAddress, not a single call. To start, you make an initialization call to BuildGlobalAddress. This call returns a session ID. You then use this session ID in subsequent calls. With each call, BuildGlobalAddress presents a list of alternative values for an address element. You select the value you want, then move on to the next address element until the complete address is built. With some exceptions, you need to make a separate call for each address element.
The overall process works like this:
- First, you make an initialization call to open a session and receive a system-assigned session ID.
- Make a search call to find possible values for a given address element.
- When you have selected the value you want, you make a commit call to indicate the value you want for the given address element.
- Continue to make search/commit calls until all address elements are committed.
- Finally, you make a close call to end the session.
To familiarize yourself with how the process works, use the Management Console's Preview tab to step through the following procedure.