ISyncChange::GetRootItemId

Obtiene el identificador del elemento cambiado.

HRESULT GetRootItemId(
  BYTE * pbRootItemId,
  DWORD * pcbIdSize);

Parámetros

  • pbRootItemId
    [in, out, unique, size_is(*pcbIdSize)] Devuelve el identificador del elemento.
  • pcbIdSize
    [in, out] Especifica el número de bytes de pbRootItemId. Devuelve el número de bytes necesarios para recuperar el identificador si pbRootItemId es demasiado pequeño, o bien, el número de bytes escritos.

Valor devuelto

  • S_OK

  • E_POINTER

  • HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pbRootItemId es demasiado pequeño. En este caso, el número necesario de bytes se devuelve en pcbIdSize.

Ejemplo

En el ejemplo siguiente se muestra la forma de obtener el identificador del elemento raíz cuando los identificadores se almacenan utilizando la estructura de SYNC_GID.

SYNC_GID gidItem;
DWORD cbID = sizeof(gidItem);
hr = pChange->GetRootItemId((BYTE*)&gidItem, &cbID);

Vea también

Referencia

Interfaz ISyncChange