int32_t __stdcall pdfGetFullyQualifiedFieldName(PPDF IPDF, uint32_t Handle, const wchar_t* Out);
function pdfGetFullyQualifiedFieldName(const IPDF: PPDF; Handle: Cardinal; var Out: PWideChar): Integer; stdcall;
Purpose. Return a field's full dotted-path name (e.g. "Parent.Child.Grandchild"), walking up through every pdfCreateGroupField ancestor (Field Creation) to assemble the complete path — the counterpart to pdfGetFieldName's partial-segment-only form.
Description. Out is an output-only var PWideChar, same disguised-output pattern as pdfGetFieldName above — always Wide, unlike the plain name getter's ANSI-only output.
Parameters.
| Parameter | Description |
|---|---|
IPDF | Document handle. |
Handle | Target field handle. |
Out | Output only — the fully-qualified dotted name. |
Return value. Name length; 0 if Handle doesn't resolve or Out is a null pointer.
See also. pdfGetFieldName, pdfCreateGroupField.
C# (P/Invoke)
public static extern int pdfGetFullyQualifiedFieldName(IntPtr IPDF, uint Handle, ref IntPtr @Out);
Getters
pdfGetFullyQualifiedFieldName
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.