ListChildren Method

Lists the child resources of one or more folders.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int ListChildren(const char* lpszFolderIds);

Unicode (Windows)
INT ListChildren(LPCWSTR lpszFolderIds);

- (void)listChildren:(NSString*)folderIds;

#define MID_GOOGLEDRIVE_LISTCHILDREN 21

IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_GoogleDrive_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This is a convenience method that works the same way as ListResources, but limits the results to children of one or more folders specified by FolderIds (which should be specified as a comma-separated list of folder resource Ids).

Calling this method will fire the ResourceList event once for each resource, and will also populate the Child* properties.

If there are still more child resources available to list when this method returns, the ChildMarker property will be populated. Continue to call this method until ChildMarker is empty to accumulate all pages of results in the Child* properties.

Note that the string "root" may be used as a folder Id to represent the root folder of a drive.

Refer to ListResources for more information about how listing resources works in general, everything there applies to this method too.

// ResourceList event handler.
googledrive.OnResourceList += (s, e) => {
  Console.WriteLine(e.Name);
};

// List all of the children of the given folder resource.
do {
  googledrive.ListChildren("12978eyuihusd");

  for (int i = 0; i < googledrive.Children.Count; i++) {
    // Process child resources here.
  }
} while (!string.IsNullOrEmpty(googledrive.ChildMarker));

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)