Checks to see if the given *manual reset* event is currently signaled. The event must not be an auto-reset event. Use when the event will only be set

Note, the error code is observed in operator!= and operator==, it always returns "equal" in the failed state to force the compare to the end iterator

* @brief Queries for number of sub-keys * @param key The HKEY to query for number of sub-keys * @param[out] numSubKeys A pointer to

* @brief Queries for number of values * @param key The HKEY to query for number of values * @param[out] numSubValues A pointer to a

get pointer to current value or nullptr if no value has been set

* @brief Queries for the filetime when the registry key was last written * @param key The HKEY to query for number of values * @para

* @brief Reads a registry value of the specified type, returning a std::vector<BYTE> * @param key An open or well-known registry key

* @brief Reads the raw bytes from a registry value under a specified key of the specified type * @param key An open or well-known registry ke

* @brief Reads a REG_MULTI_SZ value, returning a std::vector<std::wstring> * @param key An open or well-known registry key * @param

Waits on the given handle for the specified duration

Temporarily impersonates a token on this thread. This method sets a new token on a thread, restoring the current token when the returned object

Determines if a path is an extended length path that can be used to access paths longer than MAX_PATH.

* @brief Helper function to translate registry return values if the buffer was too small * @param hr HRESULT to test from registry APIs

A fail-fast variant of `make_hstring_from_buffer_nothrow`

Returns the address of the internal pointer (releases ownership of the pointer BEFORE returning the address). The pointer is explicitly released to pr

Determine if the file name is one of the special "." or ".." names.

* btw these docs are pretty useful * https://learn.microsoft.com/en-us/windows/uwp/get-started/fileio-learning-track */

Resets this managed struct by calling the custom close function Then initializes this managed struct using the user-provided initialization function,

str_raw_ptr is an overloaded function that retrieves a const pointer to the first character in a string's buffer. Overloads in this file support any s

Read data from a stream into a buffer. @code IStream* source = // ... ULONG dataBlob = 0; auto read = wil::stream_read_partial(source,

Read a string from a stream and returns an allocated copy Deserializes strings in streams written by both IStream_WriteStr and wil::stream_write_s

Seek a relative amount in a stream ~~~~ IStream* source = // ... ULONGLONG newPosition = wil::stream_seek_from_current_position(source, 16

Retrieve the size of this stream, in bytes ~~~~ IStream* source = // ... ULONGLONG size; RETURN_IF_FAILED(wil::stream_size_nothrow(sou

create using CREATE_NEW, returns handle and error code. ~~~ auto [handle, error] = wil::try_create_new_file(filePath.c_str()); ~~~ */

Compute the substring in the input value that is the parent folder path. returns: true + parentPathLength - path has a parent starting at the beginnin

Non-throwing open existing using OPEN_EXISTING, returns handle and error code. ~~~ auto [handle, error] = wil::try_open_file(filePath.c_str())

create using OPEN_ALWAYS, returns handle and error code. ~~~ auto [handle, error] = wil::try_open_or_create_file(filePath.c_str()); ~~~

create using CREATE_ALWAYS, returns handle and error code. ~~~ auto [handle, error] = wil::try_open_or_truncate_existing_file(filePath.c_str()

create using TRUNCATE_EXISTING, returns handle and error code. ~~~ auto [handle, error] = wil::try_truncate_existing_file(filePath.c_str());

* TODO: Use Shared Pointers */