WinQueryObjectPath

WinQueryObjectPath

WinQueryObjectPath(objectHandle, pathName, sizeOfPathName)

Get the path name of the object.

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:

• PMERR_INVALID_PARAMETER
• WPERR_BUFFER_TOO_SMALL
• 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);
...

Related Functions

• WinCreateObject
• WinQueryObject

OS Version Introduced

OS/2 Warp 3.0