Provides access to address book containers -- Used to perform name resolution. More...
#include <libmapi/libmapi.h>
Functions | |
_PUBLIC_ enum MAPISTATUS | GetABRecipientInfo (struct mapi_session *session, const char *username, struct SPropTagArray *pPropTags, struct SRowSet **ppRowSet) |
_PUBLIC_ enum MAPISTATUS | GetGALTable (struct mapi_session *session, struct SPropTagArray *SPropTagArray, struct SRowSet **SRowSet, uint32_t count, uint8_t ulFlags) |
_PUBLIC_ enum MAPISTATUS | ResolveNames (struct mapi_session *session, const char **usernames, struct SPropTagArray *props, struct SRowSet **rowset, struct SPropTagArray **flaglist, uint32_t flags) |
Provides access to address book containers -- Used to perform name resolution.
_PUBLIC_ enum MAPISTATUS GetABRecipientInfo | ( | struct mapi_session * | session, |
const char * | username, | ||
struct SPropTagArray * | pPropTags, | ||
struct SRowSet ** | ppRowSet | ||
) |
Retrieve Address Book information for a given recipient
session | pointer to the MAPI session context |
username | pointer to the username to retrieve information from |
pPropTags | pointer to the property tags array to lookup |
ppRowSet | pointer on pointer to the results |
Note that if pPropTags is NULL, then GetABNameInfo will fetch the following default property tags:
References MAPIFreeBuffer(), nspi_DNToMId(), nspi_GetProps(), ResolveNames(), and set_SPropTagArray().
Referenced by GetUserFreeBusyData().
_PUBLIC_ enum MAPISTATUS GetGALTable | ( | struct mapi_session * | session, |
struct SPropTagArray * | SPropTagArray, | ||
struct SRowSet ** | SRowSet, | ||
uint32_t | count, | ||
uint8_t | ulFlags | ||
) |
Retrieve the global address list
session | pointer to the MAPI session context |
SPropTagArray | pointer on an array of MAPI properties we want to fetch |
SRowSet | pointer on the rows returned |
count | the number of rows we want to fetch |
ulFlags | specify the table cursor location |
Possible value for ulFlags:
References nspi_QueryRows().
_PUBLIC_ enum MAPISTATUS ResolveNames | ( | struct mapi_session * | session, |
const char ** | usernames, | ||
struct SPropTagArray * | props, | ||
struct SRowSet ** | rowset, | ||
struct SPropTagArray ** | flaglist, | ||
uint32_t | flags | ||
) |
Resolve user names against the Windows Address Book Provider
session | pointer to the MAPI session context |
usernames | list of user names to resolve |
rowset | resulting list of user details |
props | resulting list of resolved names |
flaglist | resulting list of resolution status (see below) |
flags | if set to MAPI_UNICODE then UNICODE MAPITAGS can be used, otherwise only UTF8 encoded fields may be returned. |
Possible flaglist values are:
It is the developer responsability to call MAPIFreeBuffer on rowset and flaglist once they have finished to use them.
References nspi_ResolveNames(), and nspi_ResolveNamesW().
Referenced by AddUserPermission(), GetABRecipientInfo(), ModifyUserPermission(), and RemoveUserPermission().
![]() ![]() ![]() |
This content is licensed under the Creative Commons Attribution ShareAlike License v. 3.0: http://creativecommons.org/licenses/by-sa/3.0/ |