WinCreateObject - Parameters

pszClassName (PSZ) - input

Pointer to class name.

A pointer to a zero-terminated string which contains the name of the class of which this object is a member.

pszTitle (PSZ) - input

Pointer to initial title of object.

A pointer to a zero-terminated string which contains the initial title of the object as it is to appear when displayed on the user interface underneath an icon or on the title bar of an open object.

pszSetupString (PSZ) - input

Pointer to setup string.

See WPLaunchPad for a table of setup strings used to customize the Toolbar.

pszLocation (PSZ) - input

Folder location.

This value can be in any of the following formats:

• Predefined object ids of system folders.

  • <WP_NOWHERE>"
    The hidden folder.
    "<LOCATION_DESKTOP>"
    The currently active desktop.
    "<WP_OS2SYS>"
    The System folder.
    "<WP_TEMPS>"
    The Templates folder.
    "<WP_CONFIG>"
    The System Setup folder.
    "<WP_START>"
    The Startup folder.
    "<WP_INFO>"
    The Information folder.
    "<WP_DRIVES>"
    The Drives folder.
    
    Real name specified as a fully qualified path name.

    ulFlags (ULONG) - input

    Creation flags.

    This parameter can have one of the following values:

    CO_FAILIFEXISTS

    No object will be created if an object with the given object ID already exists. This is the default.
    CO_REPLACEIFEXISTS
    If an object with the given ID already exists, the existing object should be replaced.
    CO_UPDATEIFEXISTS
    If an object with the given ID already exists, the existing object should be updated with the new information.

    rc (HOBJECT) - returns

    Handle to the created object.

    NULLHANDLE

    Error occurred.
    Other
    A handle to the object created. This handle is persistent and can be used for the WinSetObjectData and WinDestroyObject function calls.

    ---

    [Back: WinCreateObject Return Value - rc]
    [Next: WinCreateObject - Remarks]