View source for WinQueryObjectPath

Get the path name of the object.

==Syntax==
 WinQueryObjectPath(objectHandle, pathName, sizeOfPathName)

=== Parameters ===
;objectHandle - [[HOBJECT]] - input : Object's handle.
;pathName - [[PSZ]] - output : Memory for the path name of the object.
;sizeOfPathName - [[ULONG]] - input : The size of the memory buffer for the path name - in bytes.

=== Returns ===
This function returns a [[BOOL]] with the values of:
* [[TRUE]]
* [[FALSE]]
Returns from [[WinGetLastError]] should WinQueryObjectPath fail:
* [[PM Error Codes#PMERR_INVALID_PARAMETER|PMERR_INVALID_PARAMETER]]
* [[PM Error Codes#WPERR_BUFFER_TOO_SMALL|WPERR_BUFFER_TOO_SMALL]]
* [[PM Error Codes#WPERR_OBJECT_NOT_FOUND|WPERR_OBJECT_NOT_FOUND]]

=== Define (C/C++) ===
INCL_WINWORKPLACE

=== Calling Convention ===
[[Cdecl32]]

=== Example Code ===
 ...
 HOBJECT className;
 PSZ pathName;
 ULONG sizeOfPathName; // use CCHMAXPATH plus one.
 BOOL rc;
 ...
 rc = WinQueryObjectPath (objectHandle, pathName, sizeOfPathName);
 ...

=== OS Version Introduced ===
OS/2 Warp 3.0

==Related Functions==
*[[WinCreateObject]]
*[[WinQueryObject]]

[[Category:Win]]