Share via

3.1.4.1.44 ApiDeleteGroup (Opnum 43)

  • Article

(Protocol Version 2) The ApiDeleteGroup method removes the designated group from the nonvolatile cluster state.

The server fails this method using error ERROR_DIR_NOT_EMPTY if one or more resources are contained in the group.

A client SHOULD immediately close the HGROUP_RPC handle to the group using the ApiCloseGroup method upon successful completion of this method.

The server MUST accept an ApiDeleteGroup request only if its protocol server state is read/write, as specified in section 3.1.1.

 error_status_t ApiDeleteGroup(
   [in] HGROUP_RPC Group
 );

Group: An HGROUP_RPC context handle that was obtained in a previous ApiOpenGroup or ApiCreateGroup method call.

Return Values: The method MUST return the following error codes for the specified conditions.

Return value/code

Description

0x00000000

ERROR_SUCCESS

Success.

0x00000006

ERROR_INVALID_HANDLE

The hGroup parameter does not represent a valid HGROUP_RPC context handle.

0x00000091

ERROR_DIR_NOT_EMPTY

One or more resources are contained in the group.

0x00001394

ERROR_GROUP_NOT_AVAILABLE

The group represented by the hGroup parameter is not part of the nonvolatile cluster state.

0x00001395

ERROR_GROUP_NOT_FOUND

The group represented by the hGroup parameter no longer exists in the nonvolatile cluster state.

For any other condition, the server MUST set Status to a value that is not one of the values listed in the preceding table. The client MUST treat all values that are not listed in the preceding table the same, except as specified in section 3.2.4.6.

  • The server MUST return ERROR_GROUP_NOT_AVAILABLE if, at the time the server receives the request from the client, the group represented by the hGroup parameter is not part of the nonvolatile cluster state.

  • The server SHOULD return ERROR_GROUP_NOT_FOUND if the server determines that the group represented by the hGroup parameter has already been deleted. This is determined while communicating with other servers to delete the group from the nonvolatile cluster state. The manner of determination is implementation-specific.