IPersistFileFormat.GetCurFile(String, UInt32) Método

Definição

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

Int32

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.

Aplica-se a