擷取本機電腦的唯一連絡人識別碼。
語法
HRESULT GetContactID(
[in, out] LPWSTR pszContactID,
[in] DWORD cchContactID,
[in, out] DWORD *pdwcchContactIDRequired
);
參數
[in, out] pszContactID
類型: LPWSTR
使用者配置緩衝區來儲存連絡人識別碼。
[in] cchContactID
類型: DWORD
指定配置的緩衝區大小。
[in, out] pdwcchContactIDRequired
類型: DWORD*
因緩衝區不足而失敗時,會包含 pszContactID所需的大小。 可能是 Null。
傳回值
類型: HRESULT
傳回下列其中一值:
| 傳回碼 | 描述 |
|---|---|
|
成功。 pszContactID 包含 Null 終止的 ContactID。 |
|
當 pszContactID不足以儲存值時,宏HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) 傳回。 必要的緩衝區大小會儲存在 pdwcchContactIDRequired 中。 |
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | icontact.h (include Contact.h) |
| Dll | Wab32.dll (6.0 版或更新版本) |