<!--
{
  "availability" : [
    "macOS: 10.0.0 - 10.6.0"
  ],
  "documentType" : "symbol",
  "framework" : "IOBluetooth",
  "identifier" : "/documentation/IOBluetooth/OBEXCreateVCard",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "IOBluetooth"
    ],
    "preciseIdentifier" : "c:@F@OBEXCreateVCard"
  },
  "title" : "OBEXCreateVCard"
}
-->

# OBEXCreateVCard

Creates a formatted vCard, ready to be sent over OBEX or whatever.

```
CFDataRefOBEXCreateVCard(const void *inFirstName, uint32_t inFirstNameLength, const void *inLastName, uint32_t inLastNameLength, const void *inFriendlyName, uint32_t inFriendlyNameLength, const void *inNameCharset, uint32_t inNameCharsetLength, const void *inHomePhone, uint32_t inHomePhoneLength, const void *inWorkPhone, uint32_t inWorkPhoneLength, const void *inCellPhone, uint32_t inCellPhoneLength, const void *inFaxPhone, uint32_t inFaxPhoneLength, const void *inEMailAddress, uint32_t inEMailAddressLength, const void *inEMailAddressCharset, uint32_t inEMailAddressCharsetLength, const void *inOrganization, uint32_t inOrganizationLength, const void *inOrganizationCharset, uint32_t inOrganizationCharsetLength, const void *inTitle, uint32_t inTitleLength, const void *inTitleCharset, uint32_t inTitleCharsetLength);
```

## Parameters

`inFirstName`

Pointer to data with Person’s first name.

`inFirstNameLength`

Length of Person’s first name passed in above.

`inLastName`

Pointer to data with Person’s last name.

`inLastNameLength`

Length of Person’s last name passed in above.

`inFriendlyName`

Pointer to data with Person’s Friendly name.

`inFriendlyNameLength`

Length of Person’s Friendly name passed in above.

`inNameCharset`

A pointer to the charset data used for the name. Pass in a #defined charset for ease of use.

`inNameCharsetLength`

Length of name charset assed in above.

`inHomePhone`

Pointer to data with Person’s Home phone number.

`inHomePhoneLength`

Length of Person’s Home phone number passed in above.

`inWorkPhone`

Work phone number.

`inWorkPhoneLength`

Length of Person’s Work phone number passed in above.

`inCellPhone`

Cell phone number.

`inCellPhoneLength`

Length of Person’s Cell phone number passed in above.

`inFaxPhone`

Fax phone number.

`inFaxPhoneLength`

Length of Person’s Fax phone number passed in above.

`inEMailAddress`

EMailAddress of person.

`inEMailAddressLength`

Length of Person’s EMailAddress passed in above.

`inEMailAddressCharset`

Charset of EMailAddress of person.

`inEMailAddressCharsetLength`

Length of Person’s EMailAddress charset passed in above.

`inOrganization`

Pointer to Organization/business data.

`inOrganizationLength`

Length of Organization/business data.

`inOrganizationCharset`

Pointer to the charset the Organization/business is in.

    Pointer to the charset the Title is in.

`inOrganizationCharsetLength`

Length of data for the Organization/business charset.

    Length of data for the Title charset.

`inTitle`

Pointer to data with Title of person in biz/org.

`inTitleLength`

Length of Title of person in biz/org.

## Return Value

An CFDataRef containing the compiled data. nil if we failed.

## Discussion

All parameters are optional. The CFDataRef returned to you is NOT retained. Retain it if you want to keep it.

*** DEPRECATED IN BLUETOOTH 2.2 (OS X v10.6) *** You should transition your code to Objective-C equivalents. *** This API may be removed any time in the future.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)