IItemMetadata::GetGlobalId
Obtient l'ID global de l'élément.
HRESULT GetGlobalId(
BYTE * pbGlobalId,
ULONG * pcbGlobalId);
Paramètres
- pbGlobalId
[in, out, size_is(*pcbGlobalId), unique] Retourne l'ID global de l'élément.
- pcbGlobalId
[in, out] Spécifie le nombre d'octets contenus dans pbGlobalId. Retourne le nombre d'octets requis pour récupérer l'ID global lorsque pbGlobalId est trop petit ; sinon, retourne le nombre d'octets écrits.
Valeur de retour
S_OK.
S_FALSE si l'ID global n'a pas été défini.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) lorsque pbGlobalId n'est pas assez grand pour recevoir la valeur du champ. Dans ce cas, pcbGlobalId retourne le nombre requis d'octets.
Notes
L'ID global identifie de façon unique l'élément dans toute l'étendue de la synchronisation.
Le format de l'ID retourné dépend du schéma de format d'ID spécifié lorsque le réplica a été initialisé. Pour plus d'informations sur les formats d'ID, consultez Métadonnées requises pour les fournisseurs standard.
Si IItemMetadata::SetGlobalId a été appelé pour définir la valeur de l'ID global, mais que la modification n'a pas encore été enregistrée par un appel à IReplicaMetadata::SaveItemMetadata, GetGlobalId retourne la valeur contenue dans l'objet IItemMetadata et non la valeur stockée dans le magasin des métadonnées.