| 1 | # WslcSetSessionSettingsVhd |
| 2 | |
| 3 | ```c |
| 4 | STDAPI WslcSetSessionSettingsVhd(_In_ WslcSessionSettings* sessionSettings, _In_opt_ const WslcVhdRequirements* vhdRequirements); |
| 5 | ``` |
| 6 | |
| 7 | | Parameter | Type | Direction | |
| 8 | |---|---|---| |
| 9 | | `sessionSettings` | `WslcSessionSettings*` | in | |
| 10 | | `vhdRequirements` | `const WslcVhdRequirements*` | in, optional | |
| 11 | |
| 12 | Return value: `HRESULT`. |
| 13 | |
| 14 | Header notes: |
| 15 | |
| 16 | - `WslcSetSessionSettingsVhd` rejects non-`NONE` flags with `E_INVALIDARG`. |
| 17 | - `WSLC_VHD_TYPE_FIXED` is only honored by `WslcCreateSessionVhdVolume`. |
| 18 | |
| 19 | Example: |
| 20 | |
| 21 | ```c |
| 22 | WslcVhdRequirements vhdRequirements = { 0 }; |
| 23 | vhdRequirements.name = "ignored-by-WslcSetSessionSettingsVhd"; |
| 24 | vhdRequirements.sizeBytes = (uint64_t)64 * 1024 * 1024 * 1024; |
| 25 | vhdRequirements.type = WSLC_VHD_TYPE_DYNAMIC; |
| 26 | vhdRequirements.flags = WSLC_VHD_REQ_FLAG_NONE; |
| 27 | vhdRequirements.uid = (uint32_t)0; |
| 28 | vhdRequirements.gid = (uint32_t)0; |
| 29 | |
| 30 | HRESULT hr = WslcSetSessionSettingsVhd(&sessionSettings, &vhdRequirements); |
| 31 | ``` |