Método IInitializeWithFile::Initialize (propsys.h)

Inicializa um manipulador com um caminho de arquivo.

Sintaxe

HRESULT Initialize(
  [in] LPCWSTR pszFilePath,
  [in] DWORD   grfMode
);

Parâmetros

[in] pszFilePath

Tipo: LPCWSTR

Um ponteiro para um buffer que contém o caminho do arquivo como uma cadeia de caracteres Unicode terminada em nulo.

[in] grfMode

Tipo: DWORD

Um dos seguintes valores STGM que indica o modo de acesso para pszFilePath.

STGM_READ

O arquivo indicado por IInitializeWithFile::Initialize é somente leitura.

STGM_READWRITE

O arquivo indicado por IInitializeWithFile::Initialize pode ser lido e gravado em.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Inicializar é preferencial para esse método devido à sua capacidade de usar arquivos que não são acessíveis por meio de um caminho Win32, como o conteúdo de um arquivo compactado com uma extensão de nome de arquivo .zip. Use IInitializeWithFile::Initialize somente quando a API usada pelo manipulador para acessar o arquivo aceitar apenas caminhos de arquivo.

O arquivo apontado por pszFilePath deve permanecer aberto durante o tempo de vida do manipulador ou até que IPropertyStore::Commit seja chamado.

Se o arquivo não puder ser aberto de acordo com os valores de parâmetro do método, esse método retornará um código de erro adequado.

Uma instância de manipulador deve ser inicializada apenas uma vez em seu tempo de vida. As tentativas do aplicativo de chamada de reinicializar o manipulador devem resultar no erro HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	propsys.h