Partilhar via

Classe CMonikerFile

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Representa um fluxo de dados ( IStream) nomeado por um IMoniker.

Sintaxe

class CMonikerFile : public COleStreamFile

Membros

Construtores Públicos

Nome Description
CMonikerFicheiro:CMonikerFile Constrói um CMonikerFile objeto.

Métodos Públicos

Nome Description
CMonikerFicheiro::Fechar Desliga e liberta a transmissão e liberta o apelido.
CMonikerFile::D etach Desliga o IMoniker deste CMonikerFile objeto.
CMonikerFicheiro::GetMoniker Devolve o nome atual.
CMonikerFicheiro::Open Abre o ficheiro especificado para obter um fluxo.

Métodos Protegidos

Nome Description
CMonikerFile::CreateBindContext Obtém o contexto de ligação ou criam um contexto de ligação inicializado por defeito.

Observações

Um nome contém informação semelhante a um nome de caminho para um ficheiro. Se tiver um apontador para a interface de IMoniker um objeto de nome, pode aceder ao ficheiro identificado sem ter qualquer outra informação específica sobre onde o ficheiro está realmente localizado.

Derivado de COleStreamFile, CMonikerFile toma um nome ou uma representação de cadeia que pode transformar num nome e liga-se ao fluxo para o qual o nome é o nome. Depois podes ler e escrever nesse stream. O verdadeiro objetivo é CMonikerFile fornecer acesso simples a IStreams nomeados por IMonikers para que não tenhas de te ligar a um stream tu próprio, mas mantenhas CFile funcionalidade nesse stream.

CMonikerFile não pode ser usado para se ligar a nada que não seja um fluxo. Se quiseres ligar a armazenamento ou a um objeto, tens de usar a IMoniker interface diretamente.

Para mais informações sobre streams e nomes, consulte COleStreamFile na MFC Reference e IStream e IMoniker no SDK do Windows.

Hierarquia de herança

CObject

CFile

Ficheiro COleStream

CMonikerFile

Requerimentos

Cabeçalho: afxole.h

CMonikerFicheiro::Fechar

Chame esta função para desligar e libertar o stream e libertar o nome.

virtual void Close();

Observações

Pode ser chamado em fluxos não abertos ou já fechados.

CMonikerFicheiro:CMonikerFile

Constrói um CMonikerFile objeto.

CMonikerFile();

CMonikerFile::CreateBindContext

Chame esta função para criar um contexto de ligação inicializado por defeito.

IBindCtx* CreateBindContext(CFileException* pError);

Parâmetros

pError
Um apontador para uma exceção de ficheiro. Em caso de erro, será definido como a causa.

Valor de retorno

Um apontador para o contexto de ligação IBindCtx para ligar se for bem-sucedido; caso contrário, NULL. Se a instância foi aberta com uma IBindHost interface, o contexto de ligação é recuperado do IBindHost. Se não IBindHost houver interface ou se a interface falhar em devolver um contexto de ligação, é criado um contexto de ligação. Para uma descrição da interface IBindHost , consulte o SDK do Windows.

Observações

Um contexto de ligação é um objeto que armazena informação sobre uma operação específica de ligação de nomes. Podes sobrescrever esta função para fornecer um contexto de binding personalizado.

CMonikerFile::D etach

Chama esta função para fechar o fluxo.

BOOL Detach(CFileException* pError = NULL);

Parâmetros

pError
Um apontador para uma exceção de ficheiro. Em caso de erro, será definido como a causa.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

CMonikerFicheiro::GetMoniker

Chame esta função para recuperar um ponteiro para o nome atual.

IMoniker* GetMoniker() const;

Valor de retorno

Um apontador para a interface atual do nome ( IMoniker).

Observações

Como CMonikerFile não é uma interface, o ponteiro devolvido não incrementa a contagem de referências (através do AddRef), e o nome é libertado quando o CMonikerFile objeto é libertado. Se queres manter o nome ou libertá-lo tu próprio, deves AddRef fazê-lo.

CMonikerFicheiro::Open

Chame esta função membro para abrir um ficheiro ou objeto de moniker.

virtual BOOL Open(
    LPCTSTR lpszURL,
    CFileException* pError = NULL);

virtual BOOL Open(
    IMoniker* pMoniker,
    CFileException* pError = NULL);

Parâmetros

lpszURL
Um URL ou nome de ficheiro do ficheiro a ser aberto.

pError
Um apontador para uma exceção de ficheiro. Em caso de erro, será definido como a causa.

pMoniker
Um ponteiro para a interface IMoniker do nome a ser usado para obter um fluxo.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

O parâmetro lpszURL não pode ser usado num Macintosh. Apenas a forma pMoniker de Open pode ser usada num Macintosh.

Pode usar uma URL ou um nome de ficheiro para o parâmetro lpszURL . Por exemplo:

CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("http://www.microsoft.com"));

- ou -

CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("file:c:\\mydata.dat"));

Consulte também

COleStreamFile Classe
Gráfico de Hierarquia
Classe CAsyncMonikerFile

  • Last updated on