ISyncMgrHandler：：GetName 方法 (syncmgr.h)

获取处理程序的显示名称。

语法

HRESULT GetName(
  [out] LPWSTR *ppszName
);

[out] ppszName

类型： LPWSTR*

此方法返回时，包含指向接收处理程序名称的 以 null 结尾的缓冲区的指针。名称可以是最大长度MAX_SYNCMGR_NAME，包括终止 null 字符。如果名称超过该长度，则将其截断。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

处理程序名称作为“同步中心”文件夹中的 System.DisplayName (PKEY_DisplayName) 属性进行访问。

每当调用 UpdateHandler 或 UpdateHandlerCollection 时，同步中心将调用此方法。如果 ISyncMgrHandler：：GetName 失败或返回空字符串，则处理程序不会显示在“同步中心”文件夹中，并且同步中心不会尝试调用它。

处理程序负责使用 CoTaskMemAlloc 分配字符串缓冲区。同步中心通过 CoTaskMemFree 解除分配缓冲区。

ISyncMgrHandler：：GetName 取代了使用 GetHandlerInfo 检索处理程序名称。