Параметры функций из MSDN

[Diamock]

Здравствуйте Уважаемые!
В MSDN, в описании параметров функций присутствуют обозначения, смысла которых, я понять не могу.
Пример 1: параметр функции AdjustWindowRect

Parameters
lpRect [in, out]
Type: LPRECT

Пример 2: параметр функции FindWindowEx

Parameters
hwndParent [in, optional]
Type: HWND

Что означают: in, out, optional.
С уважением...

[Dmitriy2003]

В MSDN, в описании параметров функций присутствуют обозначения, смысла которых, я понять не могу.
....
Что означают: in, out, optional.

Пора включать моск. и учить англиский.

Type: LPRECT

A pointer to a RECT structure that contains the coordinates of the top-left and bottom-right corners of the desired client area (IN). When the function returns (OUT), the structure contains the coordinates of the top-left and bottom-right corners of the window to accommodate the desired client area.

Ну а до опци"анального" параметра сам додумаешься.

[Admiralisimys]

Если программировать под Visual С++, то помимо тех значений которые объяснил Dmitriy2003 у них так же существует контролирующее свойство, доступное и для использования в своих программах для параметров функций/методов- SAL Annotations

[Diamock]

[in] – память под аргумент занимает вызывающая сторона. Функция может только читать содержимое аргумента.
[out] - память под аргумент занимает функция. Вызывающая сторона должна освободить занятый аргумент.
[in, out] - память под аргумент занимает вызывающая сторона. Функция может освободить занятую память и выделить новую. После возврата управления ответственность за освобождение памяти несет вызывающая сторона.

Вот, что вычитал по данному вопросу.
Хочется услышать комментарии.

[Admiralisimys]

Diamock нужно попрактиковаться с функциями, в которых есть аргументы с данными маркерами.
Пример для in - LoadLibrary, функции для своей работы совершенно не нужно модифицировать путь к библиотеке, перед тем как его передать сами и формируем.
out - пятый аргумент FormatMessage, достаточно (ну и в первом должно быть задействовано FORMAT_MESSAGE_ALLOCATE_BUFFER) передать не инициализированный указатель, выделение и заполнение сделает функция. Потом главное не забыть вызвать LocalFree для данного указателя.

[Diamock]

Admiralisimys, спасибо за ответ. Буду дальше разбираться.