IWABObject::VCardRetrieve method (wabapi.h)

Reads a vCard file and creates a MailUser object containing the vCard properties.

Syntax

HRESULT VCardRetrieve(
  LPADRBOOK  lpIAB,
  ULONG      ulFlags,
  LPSTR      lpszVCard,
  LPMAILUSER *lppMailUser
);

Parameters

lpIAB

Type: IAddrBook*

Pointer to an IAddrBook interface that specifies the address book object.

ulFlags

Type: ULONG

Value of type ULONG that specifies flags affecting behavior.

WAB_VCARD_FILE

Indicates that the lpszVCard parameter is the path name of the file to be read.

WAB_VCARD_STREAM

Indicates that the lpszVCard parameter points to a buffer that contains the full contents of the Vcard.

lpszVCard

Type: LPSTR

Pointer to a string containing either the complete path name of the file to be read or the vCard buffer.

lppMailUser

Type: IMailUser**

Address of a pointer to an IMailUser interface that receives the MailUser object created containing the properties in the vCard file.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Vcard retrieval is extensible. If your client application is using named properties to store client-specific data in the Windows Address Book (WAB) and exporting them to vCards, it is possible to extend the WAB vCard engine to read this data from a vCard. For more information, see Importing and Exporting Named Properties Through vCards. The lpszVCard parameter can be a pointer to a Vcard file name or a pointer to a NULL-terminated string containing the full contents of the Vcard. To have the pointer indicate which content it represents, set the ulFlags parameter to either WAB_VCARD_FILE or WAB_VCARD_STREAM. The former setting indicates a file name, and the latter setting indicates a pointer to a buffer with the Vcard contents.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wabapi.h
DLL Wab32.dll