Edit

IContact::GetContactID method (icontact.h)

  • Article

Retrieves the local computer unique contact ID.

Syntax

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

Parameters

[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.

Return value

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.

Requirements

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)

See also

IContact

Load