ISqlSyncMetadataStore::OpenStore

Открывает существующий файл хранилища метаданных и возвращает объект хранилища метаданных, представляющий этот файл.

HRESULT OpenStore(
  LPCWSTR pcszFileName,
  ULONG   ulLcid);

Параметры

• pcszFileName
  [in, string] Путь и имя файла базы данных. Путь к файлу может быть относительным. В этом случае путь задан относительно текущего каталога.

• ulLcid
  [in] Код языка для базы данных. Этот код языка должен совпадать с тем, который использовался для создания хранилища метаданных во время вызова метода ISqlSyncMetadataStore::CreateStore.

Возвращаемое значение

• S_OK

• E_POINTER

• E_INVALIDARG (если значение pcszFileName пусто).

• SYNC_E_METADATA_INVALID_OPERATION (если хранилище метаданных уже открыто, например, если метод OpenStore вызывается дважды).

• SYNC_E_METADATA_STORAGE_ENGINE_ERROR (если не удается получить доступ к хранилищу метаданных).

Замечания

Этот метод открывает существующее хранилище метаданных. Чтобы создать новый файл хранилища метаданных, воспользуйтесь методом ISqlSyncMetadataStore::CreateStore.

Безопасность Примечание.

Файл метаданных не защищен от несанкционированного доступа. Чтобы защитить файл метаданных, необходимо соответствующим образом защитить папку, в которой он находится, например, с помощью списка управления доступом на уровне пользователей (DACL). Чтобы пользователь мог удалить файл метаданных, поставщик должен при создании файла разместить его в месте, куда пользователь имеет доступ. Поставщик, создавший файл метаданных, должен удалить его при собственном удалении.

Безопасность Примечание.
Если платформа Sync Framework открывает файл метаданных с использованием удаленного механизма, такого как путь в формате UNC, одновременный доступ к нему не может быть получен ни одним приложением ни на одном компьютере, включая приложение на компьютере, где хранится файл метаданных.

См. также

Справочник

Интерфейс ISqlSyncMetadataStore