there is not ONE api.. multiple apis required..

to create a component
IWorkspaceManager destmgr = SCMPlatform.getWorkspaceManager(repo);
         destmgr.createComponent(name ,project_area_owner, null);

get the stream connection
IWorkspaceConnection desttream = destmgr.getWorkspaceConnection(workspace_handle, null);

use the ComponentOperations to add the component to the stream

deliver some changes to the stream
deststream.deliver(parms,,,);

see the javadoc. for the parms.

You cannot obtain the locks on the components for some reason. I see in your original post that you want to create the stream, workspace, and components. In your snippet, you're adding the components use the workspace as a source. Have you added the components to the workspace at that point? This may be your problem because it can't get component locks in the workspace when they don't exist in the workspace.

As Tim points out, I add the components to the stream/workspace using

private IComponentHandle renameOrCreateComponent(
        ITeamRepository teamRepository, IWorkspaceManager wm,
        IProjectArea area, IComponentHandle componentHandle,
        String componentName, IProgressMonitor monitor)
        throws TeamRepositoryException {
    if (componentHandle == null) {
        // Rename component
        componentHandle = wm.createComponent(componentName,
                teamRepository.loggedInContributor(), monitor);
        wm.setComponentOwner(componentHandle, area, monitor);
    } else {
        // Rename component
        wm.renameComponent(componentHandle, componentName, monitor);
        wm.setComponentOwner(componentHandle, area, monitor);
    }
    return componentHandle;
}

Once the component is part of the workspace, it can be used for checkin and delivery. I think I also add them to both the workspace and the stream. I am not sure if a deliver would add the components to the stream automatically.

but that should only create the component in this project area. the Workspace.addComponent() (deprecated), now use ComponentOp, is what is used to add the newly existent component TO the stream/workspace.

you don't have a stream or workspace handle/connection in your snippet.

I had the same code in my copy project area utility.. because the components were already added to the streams/workspaces on the remote system prior to my copying.