Metodo ISyncMgrHandler::GetName (syncmgr.h)

Articolo
03/05/2024

Ottiene il nome visualizzato del gestore.

Sintassi

HRESULT GetName(
  [out] LPWSTR *ppszName
);

Parametri

[out] ppszName

Tipo: LPWSTR*

Quando questo metodo restituisce, contiene un puntatore a un buffer con terminazione null che riceve il nome del gestore. Il nome può essere di lunghezza massima MAX_SYNCMGR_NAME, incluso il carattere null terminante. Se il nome supera tale lunghezza, viene troncato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il nome del gestore è accessibile come proprietà System.DisplayName (PKEY_DisplayName) nella cartella Sync Center.

Sync Center chiama questo metodo ogni volta che UpdateHandler o UpdateHandlerCollection viene chiamato. Se ISyncMgrHandler::GetName ha esito negativo o restituisce una stringa vuota, il gestore non viene visualizzato nella cartella Sync Center e Sync Center non tenterà di richiamarlo.

È responsabilità del gestore allocare il buffer di stringa usando CoTaskMemAlloc. Sync Center dealloca il buffer tramite CoTaskMemFree.

ISyncMgrHandler::GetName sostituisce l'uso di GetHandlerInfo per recuperare il nome del gestore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h

Condividi tramite