строковый атрибут (RPC)

Атрибут [строка] указывает, что параметр является указателем на массив типов char, байтовили w_char. Как и в случае с соответствующим массивом, размер параметра [string] определяется во время выполнения. В отличие от соответствующего массива, разработчику не нужно предоставлять длину, связанную с массивом, — атрибут [string] указывает заглушку, чтобы определить размер массива путем вызова strlen. Атрибут [string] нельзя использовать одновременно с атрибутами [length_is] или [last_is].

Сочетание атрибутов [in, string] направляет заглушку для передачи строки только от клиента к серверу. Объем памяти, выделенной на сервере, совпадает с объемом передаваемой строки плюс один.

Атрибуты [out, string] направляют заглушку, чтобы передать строку только с сервера на клиент. Конструкция по вызову языка C настаивает на том, что все [out] параметры должны быть указателями.

Параметр [out] должен быть указателем, и по умолчанию все параметры указателя являются ссылочными указателями. Указатель ссылки не изменяется во время вызова— он указывает на ту же память, что и перед вызовом. Для строковых указателей дополнительное ограничение ссылочного указателя означает, что клиент должен выделить достаточную допустимую память перед вызовом удаленной процедуры. Заглушки передают строку, которую [out, string] атрибуты указывают в память, уже выделенную на стороне клиента.

В следующих разделах описаны прототипы параметров удаленной процедуры для строк:

• [in, out, string] Прототип
• [in, string] и [out, string] Прототип