IContact::GetContactID method (icontact.h)

Retrieves the local computer unique contact ID.

Syntax

HRESULT GetContactID(
  [in, out] LPWSTR pszContactID,
  [in]      DWORD  cchContactID,
  [in, out] DWORD  *pdwcchContactIDRequired
);

[in, out] pszContactID

Type: LPWSTR

User allocated buffer to store the contact ID.

[in] cchContactID

Type: DWORD

Specifies allocated buffer size.

[in, out] pdwcchContactIDRequired

Type: DWORD*

Upon failure due to insufficient buffer, contains the required size for pszContactID. May be NULL.

Type: HRESULT

Returns one of the following values:

Return code	Description
S_OK	Success. pszContactID contains a null-terminated ContactID.
ERROR_INSUFFICIENT_BUFFER	Macro HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) returned when pszContactID was not large enough to store the value. The required buffer size is stored in pdwcchContactIDRequired.

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	icontact.h (include Contact.h)
DLL	Wab32.dll (Version 6.0 or later)