Função DismOpenSession
Associa uma imagem offline ou online do Windows a uma DISMSession.
Sintaxe
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
Parâmetros
ImagePath [in]
Defina ImagePath como um dos seguintes valores:
- Um caminho absoluto ou relativo para o diretório raiz de uma imagem offline do Windows.
- Um caminho absoluto ou relativo para o diretório raiz de uma imagem montada do Windows. Você pode montar a imagem antes de chamar DismOpenSession usando uma ferramenta externa ou usando DismMountImage.
- DISM_ONLINE_IMAGE associar a Sessão à instalação online do Windows.
WindowsDirectory [in, opcional]
Opcional. Um caminho relativo ou absoluto para o diretório do Windows. O caminho é relativo ao ponto de montagem.
Se o valor de WindowsDirectory for NULL, o valor padrão de "Windows" será usado.
O parâmetro WindowsDirectory não pode ser usado quando o parâmetro ImagePath é definido como DISM_ONLINE_IMAGE.
SystemDrive [in, opcional]
Opcional. A letra da unidade do sistema que contém o gerenciador de inicialização. Se SystemDrive for NULL, o valor padrão da unidade que contém o ponto de montagem será usado.
O parâmetro SystemDrive não pode ser usado quando o parâmetro ImagePath é definido como DISM_ONLINE_IMAGE.
Sessão [out]
Uma DismSession válida. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando DismOpenSession.
Retornar valor
Retornará S_OK se houver êxito.
Retornará HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) se a DismSession já tiver uma imagem associada a ela.
Retorna um código de erro Win32 mapeado para um HRESULT para outros erros.
Comentários
A DismSession pode ser usada para atender à imagem depois que a chamada DismOpenSession for concluída com êxito. A DismSession deve ser desligada chamando DismCloseSession.
Exemplo
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Requisitos
| Requisito | Descrição |
|---|---|
| Plataformas de host com suporte | A API DISM pode ser usada em qualquer sistema operacional compatível com o Windows ADK (Kit de Avaliação e Implantação). Para obter mais informações, consulte a Referência técnica do Windows ADK |
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |