Función DismOpenSession
Asocia una imagen de Windows sin conexión o en línea con una DISMSession.
Sintaxis
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
Parámetros
ImagePath [in]
Establezca ImagePath en uno de los valores siguientes:
- Ruta de acceso absoluta o relativa al directorio raíz de una imagen de Windows sin conexión.
- Ruta de acceso absoluta o relativa al directorio raíz de una imagen de Windows montada. Puede montar la imagen antes de llamar a DismOpenSession mediante una herramienta externa o mediante DismMountImage.
- DISM_ONLINE_IMAGE asociar la sesión a la instalación de Windows en línea.
WindowsDirectory [in, opcional]
Opcional. Ruta de acceso relativa o absoluta al directorio de Windows. La ruta de acceso es relativa al punto de montaje.
Si el valor de WindowsDirectory es NULL, se usa el valor predeterminado de "Windows".
El parámetro WindowsDirectory no se puede usar cuando el parámetro ImagePath está establecido en DISM_ONLINE_IMAGE.
SystemDrive [in, opcional]
Opcional. Letra de la unidad del sistema que contiene el administrador de arranque. Si SystemDrive es NULL, se usa el valor predeterminado de la unidad que contiene el punto de montaje.
El parámetro SystemDrive no se puede usar cuando el parámetro ImagePath está establecido en DISM_ONLINE_IMAGE.
Sesión [salida]
Valor de DismSession válido. DismSession debe estar asociado a una imagen. Puede asociar una sesión a una imagen mediante DismOpenSession.
Valor devuelto
Devuelve S_OK si se realiza correctamente.
Devuelve HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) si dismSession ya tiene una imagen asociada.
Devuelve un código de error win32 asignado a un HRESULT para otros errores.
Comentarios
DismSession se puede usar para atender la imagen después de que la llamada DismOpenSession se complete correctamente. La DismSession debe apagarse llamando a DismCloseSession.
Ejemplo
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas host soportadas | El API de DISM puede usarse en cualquier sistema operativo que Windows Assessment and Deployment Kit (Windows ADK) soporte. Para obtener más información, consulta la Referencia técnica de Windows ADK. |
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| Archivo DLL | DismAPI.dll |