bstr_object_rename(3) — Subroutines

Name

bstr_object_rename − Renames an object.

Syntax

bstr_t_status bstr_object_rename (
               bstr_t_reference ∗object,
               bstr_t_name      new_name,
               bstr_t_rcb       ∗control);

Description

The bstr_object_rename procedure allows you to rename the object to new_name. However, you cannot change the path of the object.

Arguments

object
access: read
The current address of the object that you wish to rename.

new_name

access: read
The new name of the object.

control

access: read The address of the optional request control block.

Return Values

BSTR_S_NORMAL	Normal successful completion
BSTR_S_BAD_PARAMETER	Invalid parameter value
BSTR_S_INVALID_OPERATION	Invalid operation
BSTR_S_NOT_INITIALIZED	BASEstar Open not initialized
BSTR_S_INVALID_RCB	Invalid Request Control Block