IItemMetadata::GetGlobalId
Obtiene el identificador global del elemento.
HRESULT GetGlobalId(
BYTE * pbGlobalId,
ULONG * pcbGlobalId);
Parámetros
- pbGlobalId
[in, out, size_is(*pcbGlobalId), unique] Devuelve el identificador global del elemento.
- pcbGlobalId
[in, out] Especifica el número de bytes de pbGlobalId. Devuelve el número de bytes necesarios para recuperar el identificador global si pbGlobalId es demasiado pequeño; en caso contrario, devuelve el número de bytes escritos.
Valor devuelto
S_OK.
S_FALSE si no se ha establecido el identificador global.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pbGlobalId no es suficientemente grande para recibir el valor del campo. En este caso, pcbGlobalId devuelve el número necesario de bytes.
Notas
El identificador global identifica de forma única el elemento en todo el ámbito de sincronización.
El formato del identificador depende del esquema de formato de identificador especificado cuando se inicializó la réplica. Para obtener información acerca de los formatos de identificador, vea Requisitos de metadatos para proveedores estándar.
Si se llamó a IItemMetadata::SetGlobalId para establecer el identificador global, pero el cambio no se ha guardado aún mediante una llamada a IReplicaMetadata::SaveItemMetadata, GetGlobalId devuelve el valor incluido en el objeto IItemMetadata y no el valor almacenado en el almacén de metadatos.