3.2.4.7 Closing a Context Handle

  • Article

If a context handle has been registered with a version 1 notification port event filter, then the client SHOULD post a CLUSTER_CHANGE_HANDLE_CLOSE (section 2.2.2.7) event indication to the client-side queue of events when the context handle is closed. Context handles are registered with a notification port event filter as specified in following sections:

  • ApiAddNotifyNode (section 3.1.4.1.59 for protocol version 2, or 3.1.4.2.59 for protocol version 3)

  • ApiAddNotifyGroup (section 3.1.4.1.60 for protocol version 2, or 3.1.4.2.60 for protocol version 3)

  • ApiAddNotifyResource (section 3.1.4.1.61 for protocol version 2, or 3.1.4.2.61 for protocol version 3)

  • ApiAddNotifyKey (section 3.1.4.1.62 for protocol version 2, or 3.1.4.2.62 for protocol version 3)

  • ApiAddNotifyNetwork (section 3.1.4.1.90 for protocol version 2, or 3.1.4.2.90 for protocol version 3)

  • ApiAddNotifyNetInterface (section 3.1.4.1.99 for protocol version 2, or 3.1.4.2.99 for protocol version 3)

If a context handle has been registered with a version 2 notification port event filter, then the client SHOULD post an event indication to the client-side queue of events when the context handle is closed as follows:

  • For HCLUSTER_RPC, CLUSTER_CHANGE_CLUSTER_HANDLE_CLOSE_V2 (section 2.2.2.12).

  • For HGROUP_RPC, CLUSTER_CHANGE_GROUP_HANDLE_CLOSE_V2 (section 2.2.2.13).

  • For HRES_RPC, CLUSTER_CHANGE_RESOURCE_HANDLE_CLOSE_V2 (section 2.2.2.14).

  • For HNETINTERFACE_RPC, CLUSTER_CHANGE_NETINTERFACE_HANDLE_CLOSE_V2 (section 2.2.2.16).

  • For HNETWORK_RPC, CLUSTER_CHANGE_NETWORK_HANDLE_CLOSE_V2 (section 2.2.2.17).

  • For HNODE_RPC, CLUSTER_CHANGE_NODE_HANDLE_CLOSE_V2 (section 2.2.2.18).

  • For HKEY_RPC, CLUSTER_CHANGE_REGISTRY_HANDLE_CLOSE_V2 (section 2.2.2.19).

  • For HGROUPSET_RPC, CLUSTER_CHANGE_GROUPSET_HANDLE_CLOSE_v2 (section 2.2.2.24).

Context handles are registered with a notification port event filter as specified for ApiAddNotifyV2 (section 3.1.4.2.137) (for protocol version 3).

For both version 1 and version 2 notification port handle close event indications, the object name associated with the context handle is the object name associated with the event indication except for cluster registry context handles where the object name returned is the NULL string.

A context handle is closed using its corresponding close methods, as specified in the following sections: