ISqlSyncMetadataStore::OpenStore

Abre um arquivo de repositório de metadados existente e retorna um objeto de repositório de metadados que o representa.

HRESULT OpenStore(
  LPCWSTR pcszFileName,
  ULONG   ulLcid);

Parâmetros

• pcszFileName
  [in, string] O caminho e o nome do arquivo de banco de dados. O caminho do arquivo pode ser um caminho relativo. Neste caso, ele é relativo ao diretório atual.

• ulLcid
  [in] A ID da localidade do banco de dados. Deve ser a mesma ID de localidade usada para criar o repositório de metadados quando ISqlSyncMetadataStore::CreateStore foi chamado.

Valor de retorno

• S_OK

• E_POINTER

• E_INVALIDARG quando pcszFileName estiver vazio.

• SYNC_E_METADATA_INVALID_OPERATION quando o repositório de metadados já estiver aberto, o que ocorre quando OpenStore é chamado duas vezes.

• SYNC_E_METADATA_STORAGE_ENGINE_ERROR quando não for possível acessar o repositório de metadados.

Comentários

Este método abre um repositório de metadados existente. Para criar um novo arquivo de repositório de metadados, use ISqlSyncMetadataStore::CreateStore.

Segurança Observação:

O arquivo de metadados não é protegido contra acesso não autorizado. Para ajudar a proteger o arquivo de metadados, a pasta que o contém deve ser protegida corretamente, por exemplo, usando uma DACL (Lista de Controle de Acesso Discricionário). Para permitir que o usuário exclua o arquivo de metadados, o provedor que o cria deve colocá-lo em algum lugar que o usuário possa acessar. O provedor que cria o arquivo de metadados deve excluí-lo ao ser desinstalado.

Segurança Observação:
Quando o Sync Framework abre o arquivo de metadados por um mecanismo remoto, como um caminho UNC, o arquivo de metadados não pode ser acessado simultaneamente por nenhum outro aplicativo em nenhum computador, incluindo um aplicativo na máquina na qual o arquivo de metadados está armazenado.

Consulte também

Referência

Interface ISqlSyncMetadataStore