atrybut string (RPC)

Atrybut [ string] wskazuje, że parametr jest wskaźnikiem do tablicy typu char, bajtówlub w_char. Podobnie jak w przypadku zgodnej tablicy, rozmiar [ciąg] parametru jest określany w czasie wykonywania. W przeciwieństwie do zgodnej tablicy deweloper nie musi podać długości skojarzonej z tablicą — atrybut [string] informuje wycinkę, aby określić rozmiar tablicy, wywołując strlen. Atrybut [string] nie może być używany w tym samym czasie co atrybut [length_is] lub [ last_is].

Kombinacja atrybutów [in, string] przekierowuje wycinkę, aby przekazać ciąg tylko z klienta do serwera. Ilość pamięci przydzielonej na serwerze jest taka sama jak rozmiar przesyłanego ciągu plus jeden.

Atrybuty [ , ciągu] kierują wycinkę, aby przekazać ciąg tylko z serwera do klienta. Projekt wywołania według wartości języka C podkreśla, że wszystkie parametry [out] muszą być wskaźnikami.

Parametr [out] musi być wskaźnikiem, a domyślnie wszystkie parametry wskaźnika są wskaźnikami odniesienia. Wskaźnik odniesienia nie zmienia się podczas wywołania — wskazuje na tę samą pamięć, co przed wywołaniem. W przypadku wskaźników ciągów dodatkowe ograniczenie wskaźnika odniesienia oznacza, że klient musi przydzielić wystarczającą prawidłową pamięć przed wykonaniem zdalnego wywołania procedury. Wycinki przesyłają ciąg, który [out, string] atrybuty wskazują na pamięć już przydzieloną po stronie klienta.

W poniższych tematach opisano prototypy parametrów procedury zdalnej dla ciągów:

• [in, out, string] Prototyp
• [in, string] i [out, string] Prototyp