IPersistFileFormat.GetCurFile(String, UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna o caminho para o arquivo de trabalho atual de um objeto ou, se não houver um arquivo de trabalho atual, o prompt de nome de arquivo padrão do objeto.
public:
int GetCurFile([Runtime::InteropServices::Out] System::String ^ % ppszFilename, [Runtime::InteropServices::Out] System::UInt32 % pnFormatIndex);
int GetCurFile([Runtime::InteropServices::Out] std::wstring const & & ppszFilename, [Runtime::InteropServices::Out] unsigned int & pnFormatIndex);
public int GetCurFile (out string ppszFilename, out uint pnFormatIndex);
abstract member GetCurFile : string * uint32 -> int
Public Function GetCurFile (ByRef ppszFilename As String, ByRef pnFormatIndex As UInteger) As Integer
Parâmetros
- ppszFilename
- String
fora Ponteiro para o nome do arquivo. Se o objeto tiver um nome de arquivo válido, o nome do arquivo será retornado como o ppszFilename parâmetro out. Se o objeto estiver no estado sem título, null será retornado como o ppszFilename parâmetro out.
Observe que esse resultado é diferente do GetCurFile(String) método padrão, que retorna S_FALSE e uma cadeia de caracteres de prompt "salvar como".
- pnFormatIndex
- UInt32
fora Valor que indica o formato atual do arquivo. Esse valor é interpretado como um índice de base zero na lista de formatos, conforme retornado por uma chamada para GetFormatList(String) . Um valor de índice igual a zero indica o primeiro formato, 1 o segundo formato e assim por diante. Se o objeto der suporte apenas a um único formato, ele retornará zero. Subsequentemente, ele retorna um único elemento em sua lista de formatos por meio de uma chamada para GetFormatList(String) .
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Assinatura COM
De fpstfmt. idl:
HRESULT IPersistFileFormat::GetCurFile(
[out] LPOLESTR *ppszFilename,
[out] DWORD *pnFormatIndex
);
Esse método é semelhante a GetCurFile. Para salvar o arquivo atual no formato atual, chame GetCurFile para recuperar o valor de índice do formato atual a fim de passá-lo adequadamente para o Save método.